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WELCOME 
to The MagP1 102 


here are times when Raspberry Pi releases something that 
changes everything. Raspberry Pi Pico (page 60) is exactly one 
of those moments. 

Pico is a ‘microcontoller board’. Smaller, even, than a Raspberry Pi 
Zero, it is made possible thanks to a brand-new, ultra-fast, super- 
small, silicon chip called RP2040. Silicon designed by Raspberry Pi 
itself. How exciting! 

I’m smitten with Pico and the possibilities it offers. I spent 
most of the Christmas break playing around with it. It’s genuinely 
revolutionary. Gareth Halfacree has written us a massive feature, and 
we ve got a full tutorial and guide to getting started. 

Meanwhile, Rob has built the ultimate media player with Raspberry 
Pi 4. This incredible project can do it all: play movies, run games, 
stream online video, photos, music. You name it. 

On top of that, we’ve got some amazing tutorials this month. Check 
out KG’s Commodore 64 where they turn a Raspberry Pi 400 into a 
pixel-perfect retro computer (page 50), and PJ’s guide to Raspberry 
Pi 400 electronics with Flat HAT 
Hacker (page 40). NEW! RASPBERRY pI - 

This issue is packed with 
Raspberry Pi and the ever- 
increasing of things you can make 
with them. 2021 is going to be an 
amazing year to be a digital maker. 
Happy new year! 
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Lucy 
Hattersley 





Lucy is editor of The 
MagPi and quite 
firmly recommends 
that you take out a 
subscription to The 
MagPi magazine 
right away. 


@LucyHattersley 
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Subscribe to The MagPi, HackSpace magazine, or Custom PC. Your first three issues for £10, then our great value rolling subscription 
afterwards. Includes a free voucher for one of five fantastic books at store.rpipress.cc/collections/latest-bookazines 
UK only. Free delivery on everything. 
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Cheap All Sky Camera o& pe Se Turing Machine Demonstrator 


DISCLAIMER: Some of the tools and techniques shown in The MagPi magazine are dangerous unless used with skill, experience, and appropriate personal protection equipment. While 
we attempt to guide the reader, ultimately you are responsible for your own safety and understanding the limits of yourself and your equipment. Children should be supervised. Raspberry 
Pi (Trading) Ltd does not accept responsibility for any injuries, damage to equipment, or costs incurred from projects, tutorials or suggestions in The MagPi magazine. Laws and regulations 
covering many of the topics in The MagPi magazine are different between countries, and are always subject to change. You are responsible for understanding the requirements in your 
jurisdiction and ensuring that you comply with them. Some manufacturers place limits on the use of their hardware which some projects or suggestions in The MagPi magazine may go 
beyond. It is your responsibility to understand the manufacturer's limits. 
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Electronics with Raspberry Pi 400 
Create GUIs with Python — part 2 
Raspberry P1 400 C64 emulator 
Add face recognition to projects 
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Cheap Trills — part 1 Raspberry Pi 400 
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NanoSound ONE 

Grow Kit 
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Learn MicroPython 


Kids Invent Stuff interview 
This Month in Raspberry P1 
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Kids Invent Stuff interview 





Do you know 






Buy in Canada: 


BuyaPi.ca/stereopi 





LinuxGizmos.com 

“The StereoPi can capture, save, 
livestream, and process real-time 
stereoscopic video and images for 
robotics, AR/VR, computer vision, drone 


instrumentation, and panoramic video.” 
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HOW ROBOTS SEE? 





RASPBERRY PI INSIDE 


MickMake 

“With it you can do things like, stream 
stereoscopic 3D video to YouTube, build 
real-time depth maps using OpenCV, 
create panoramics using Hugin and even 
a 3rd person view of real life. Cool.” 


@ Geeky Gadgets 


StereoPi is an open source stereoscopic 
camera, based on Raspberry Pi. 








This is the friendliest way to play with 
the stereoscopic vision for the spatially 
aware robots, 3D photo and video! 





La - 
Raspbian 
STOCK RASPBIAN OPEN SOURCE CROWDFUNDED 
SUPPORT PROJECT 


Hackster News 

“You can hook this up to YouTube, 
to Oculus Go, you can use it with 
OpenCV.. | cannot wait to start 
messing around with these because 
it’s basically a dream come true.” 


Raspberry Pi Blog 

“There are some excellent 
community efforts too, of 
which our current 
favourite is this nifty dual 
camera board.” 
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Raspberry Pi releases 
IQaudi1o products 


[Qqudio range joining Raspberry Pi is ag sound move. By Lucy Hattersley 


V_ IQaudio DAC Pro. 


Priced at $25, DAC Pro 
is |Qaudio's highest- 
fidelity audio output 
HAT. It supports the 
same audio input 
formats and output 
connectors as DAC}, 
but uses a Texas 


Instruments PCM5242 
DAC, providing an 
even higher signal-to- 
noise ratio 


aspberry Pi is bringing four IQaudio 
products to market after acquiring the 
brand in late 2020. 
“This is the first time we’ve brought third- 
party products into our line-up like this,” 
says Roger Thornton, Principal Hardware 
Engineer at Raspberry Pi, on Raspberry Pi’s blog 
(magpi.cc/iqaudioblog). “When the opportunity 
arose to acquire IQaudio’s brand and product line 
late last year, we jumped at it.” 
The change means IQaudio products 
are listed on Raspberry Pi’s products page 
(magpi.cc/products) and are available from 
Raspberry Pi resellers, where they maintain the 
IQaudio brand. 
IQaudio was founded in 2015 by Gordon and 
Sharon Garrity, together with Andrew Rankin. It 
was “one of the first companies to recognise the 






P IQaudio DigiAMP*. \\/hereas DAC+ and DAC Pro 
are designed to be used with an external amplifier, 


potential of Raspberry Pi as a platform for hi-fi 
audio,” adds Roger. 

Hi-fi audio is a new market for Raspberry Pi. 
“We’ve never felt we had the capabilities needed 
to offer something distinctive,” says Roger, 
“leaving third parties to step in with a variety of 
audio I/O devices. 


M™ This ts the first time we've 
Drought third-party products 
into our line-up 


“TQaudio products are widely used by hobbyists 
and businesses, with in-store audio streaming 
being a particularly popular use case).” 

The four most popular IQaudio products 
for Raspberry Pi - DAC+, DAC Pro, DigiAMP+, 
and Codec Zero — are all available to buy via 
Raspberry Pi Approved Resellers. Hl 


DigiAMP+ integrates a Texas Instruments TAS5756M 
digital-input amplifier directly onto the HAT, allowing 
you to drive a pair of passive speakers at up to 35 W 
per channel. Combined with a Raspberry Pi board, it’s 


a complete hi-fi the size of a deck of cards 
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A |Qaudio DAC+. Priced at $20, DAC+ is the lowest-cost audio 
output HAT, supporting 24-bit 192kKHz high-resolution digital 
audio. It uses a Texas Instruments PCM5122 DAC to deliver 
stereo analogue audio to a pair of phono connectors, and 
also provides a dedicated headphone amplifier 


IQaudio Codec Zero. Codec Zero is a $20 audio I/O HAT, 
designed to fit within the Raspberry Pi Zero footprint. It 

is built around a Dialog Semiconductor DA7212 codec 
and supports a range of input and output devices, from 
the built-in MEMS microphone to external mono electret 
microphones and 1.2W, 8 ohm mono speakers 





with Raspberry Pi & PiShop! 


Desktop Computer | Learning to Code! 3D Printing | Robotics 
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The fax machine in the 
performance is more than 
just a fax machine 


A company of global artists put on g remote performance with some upgraded 
retro tech, thanks to a Raspberry Pi, Rob Zwetsloot watches the show 


_ ANTS 


An experimental, 
new-age theatre 
company formed of 
six freelance artists 
from across 

the world. 


magpi.cc We Still Fax 


eople have been finding new ways to stay 
entertained in 2020 — there’s even been 
a resurgence in drive-in movie theatres. 
The ANTS Theatre company also decided to try 
something new. 
“Imagine immersive theatre crossed with an 
escape room, but in your home - and that’s We 


Still Fax” Paul Hernes Barnes of the ANTS explains. 


“We wanted to make a real, live theatre show that 
was Offline and tactile. We Still Fax is our solution; 
it’s a whole new form of theatre.” 

People taking part receive a special fax machine 
in the post — hence the name of the show - which 
they interact with as it ‘comes alive’ during the 
performance. It uses sound, light, touch, smell, 
smoke, and faxes throughout. 

As the ANTS describe it: “You receive a 
mysterious machine in the post. You plug it in and 
something strange happens... You connect with 


an alternate dimension; one in which the internet 
doesn’t exist and someone needs your help. To 
take on this incredibly important mission, you 
will need to crack codes, send faxes, unlock secret 
hatches and, when the time comes, push the big, 
red button. They are counting on you; their world 
depends on it.” 


Indistinguishable from magic 
Unfortunately, we have to break the illusion of 
the show by revealing that this interdimensional 
device is in fact a modified fax machine that uses a 
Raspberry Pi, among other things. 

“The core components of the show are thte 
fax machine, Grandstream, and Raspberry Pi,” 
the ANTS tell us. “In short, the Grandstream 
is an ATA (analogue telephone adapter) which 
translates phone signal into Ethernet signal and 
vice versa.” 





. 
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This is the first 
time they've used 
Raspberry Pi in 

a performance 


_ 7 


You receive g mysterious machine in the post. saves 
4 , You plug it in and something strange happens they have seems to 


involve Raspberry 
Pi now 


The ANTS have 
been working on 
this since April 


The ANTS want to 
bring ‘faxy’ back 


Designing and 
testing has 

been going on 
throughout 2020 
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THE COMPLETE STEP-BY-STEP 
DIGITAL LEARNING BUNDLE FOR 





_ Save hours and hours of searching the internet for tutorials 
~ Learn Raspberry Pi in a structured, step-by-step, how-to guide 
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Progress to building complex projects 
- Learn Raspberry Pi, programming and electronics 
- Get help and support when YOU need it 





Learn to build projects like an Amazon Alexa Clone, Motion Sensor Alarm, work with 
cameras and build projects that control any device tn your home with your voice! 


WHAT YOU GET IN THIS BUNDLE: 


The most comprehensive way to learn the Raspberry Pi, build hands-on projects, 
learn programming and electronics! 


$1,000 value, now over 90% off, ONLY $99 for a limited time! 


MagPi 


Magic fax machine 





As part of the show, Raspberry Pi receives a 
fax / phone call sent from the audience and 
adds the appropriate information into the database. 





The Python manager detects a change in the 
database and updates the current step so that 
the rest of the show knows what to do. 





Audience members use the machine to make A sneak peek at all the 
, : different bits and pieces 
phone calls and send faxes, which are interpreted feral be ales ints 
by Raspberry Pi to activate effects. the final kit 


“Apart from these three, we have an LED 
strip which is controlled through GPIOs,” the 
team continue. “From these we also control the 
MicroFogger 2: a micro smoke machine. Finally, 
sound comes through speakers which are, again, 
connected to Raspberry Pi.” 

When it comes to software, all the distribution 
and management of calls, sounds, lights and 
smoke is done in a Python script that’s constantly 
running in the background. “We use Asterisk, 
an Open-source communication software, to 
interpret calls. Asterisk provides an in-built 





The Python manager launches calls, sounds, 

lights, smoke of the current step. These will 
lead the audience onto the next phone call / fax they 
database, which we use to communicate between have to make. 


Asterisk and Python.” 
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> The escape room inspiration 
is a great way to make this 
performance work at home 


Even test performances 
didn't quite go to plan, so 
testing was essential 
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Performances have been going on, with varying 
success. “The technical components of We Still 
Fax are complex and there have been a fair few 
issues to overcome!” the ANTS reveal. “While 
incredibly well-received, the initial research and 
development performances were patchy in terms 
of reliability - from the ‘perfect’ performance to 
one in which we had to abandon the machine for 
an internet version, there were a lot of learnings!” 


Learning process 
These sharings were crucial trials that enabled 
them to understand how different users would play 
differently — and what that would mean for the 
programming. “Operating the tech remotely was 
a significant challenge and we have developed a 
‘rescue’ button that will both reboot the machine 
and re-send us access to Raspberry Pi via email.” 
They also uncovered a flaw in the overall box 
design: “During one show, a plug located inside 
the casing of the fax machine fell out! We have 
now refined the code, design, aesthetic, timing and 
theatrics, as well as planted Easter eggs throughout 
the player’s journey! The content, design, and code 
are now in a good place to begin our first string of 
commercial performances — we can’t wait!” 
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Robotics & rapid prototyping 
with your ®aspoderry P: 


Power your projects with computer vision and applied AI 


pi-top [4] Robotics Kit comes with electronic components such as a wide-angle 
camera, servos and motors, all of which plug and play with the pi-top [4] 
Complete or pi-top [4] DIY Edition’. 


pi-top Robotics Kit with Expansion Plate 
187.90 / $199.90 
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Raspberry Pi is a trademark of the Raspberry Pi Foundation. ‘pi-top [4] and Robotics Kit with Expansion Plate sold separately. © CEED Ltd. 2021 


Raspberry Pi made simple, robust and modular. 
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Cheap All Sky Camera 


Keen astronomers can keep an eye on the night sky and capture 
meteors and satellites, as David Crookes explains 





Jippo lives in 
Finland and as well 
as being interested 
in computing, 
programming, and 
Linux, he's a keen 
amateur astronomer 
and photographer. 


magpi.cc/ 
allskycam 


Meteotux Pi is easy 
to set up: install 

the software ona 
Raspberry Pi and 

run it with simple 
parameters. The 
parameters can be 
checked from the 
control line by typing 
./meteotux_pi 


Introduction 


What is Metecbux Pl? 


Program to record continuous high resolution images of night thee fireballs, 


aeroplanes, satellite Tastes. etic. 


Why program exists? 


Program won made for attroncmy neeearch, Program reconds nontinucen bong 
expos ream from camera eenuring that there lp ng melying frames bebveren 
expouures and even bebween produced jpg fier, [Please oee the “hateliite fy by” 


amples. 


What you need torun software? 


Raipterry Pi + WSb-poer fusehe 


eteors can be seen across the sky when 

it’s not cloudy, but you need to be away 

from bright lights and looking in the 
right place at the right time. This is easier said 
than done, particularly if you also want to capture 
the precise moment on camera. What you need is 
a device that can scan a wide field of sky, and snap 
away whenever it picks up something bright. 

The Cheap All Sky Camera certainly fits the 
bill. Created by Jippo — whose nickname is a 
reference to a late 1970s and early 1980s Finnish 
magazine that encouraged readers to build — it 
uses a Raspberry Pi 4, as well as the High Quality 
Camera fitted with a 180-degree CS lens. These 
components sit under a 20cm acrylic dome, 
protecting them from the weather. 


Stars in their eyes 

“Before this there was a similar project that used 
Linux, a normal computer, a video capture card and 
a security camera containing a charged-coupled 
device,” says Jippo. “But with Raspberry Pi you 





Sample images taken with 
Meteabur Pil 


CT bruygpes be dee where full aaneal 





16 | magpicc | Cheap All Sky Camera 


can build a really cheap and small setup with 
everything that’s needed placed inside a dome.” 
The build was inspired by the Meteotux Pi 
program written by Jippo’s friend Jani, developed 
to record continuous high-resolution images 
during the night. “Jani and I had joined an amateur 
astronomy association here in Finland called URSA, 
and there was a group using Windows computers 
to capture sky events in order to calculate and 
identify meteors and meteor showers,” says Jippo. 


mM With Raspberry Pi you can 
build a really cheap and 
Small setup 


“We were both using a Linux computer and 
we had the idea of developing a Linux program 
to capture those sky events. Meteotux Pi was 
developed after Raspberry Pi came with a hi-res 
[HQ Camera].” This keeps costs to a minimum, 
especially since Meteotux Pi will also work with 
older Raspberry Pi models and Camera Modules. 





A. Rather than record video, Meteotux Pi saves a 


series of long-exposure photos that are stacked ¢ , 1a 


in one image so that no frames are lost all night fa? ee ee 
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the camera a clear view of the sky 
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A Raspberry Pi computer runs Raspberry Pi 
OS Lite and it’s automated to run Meteotux Pi 
at sunset, stopping at sunrise. “A simple Shell 
script runs daily and checks for these times before 
generating command-line options for the program 
and running them,” Jippo explains. 

“After Meteotux Pi has taken the images, a 
Python Shell script starts to generate star trails 
and normal video from stacked images. This script 
uses ImageMagick and FFmpeg and when they are 
ready, lit] moves those images and videos to my 
network drive via WiFi where I can check them.” 


Just warming up 

To prevent the device from getting too cold, given 
it is going to be located outside all night, Jippo has 
used a second Raspberry Pi computer — a Raspberry 
Pi 3+ with a V2 colour camera, relay controller HAT, 
and temperature sensor. 

“The sensor monitors the temperature inside 
the dome and if it gets too cold, the relay board 
will turn the 10 W heat resistors on. This keeps the 
dome clear from humidity or frost and it removes 
raindrops a lot faster too,” he reveals. 


Raspberry Pi's High Quality 
(Or-Taal=1¢- Mal \oe-6) ©) ole) a ace) Ore 
laalelelalm (=valci=s-yre like lale ma alls 
project to use a 180-degree lens 








The result has been many hours of pleasure 
as Jippo and Jani discover the countless delights 
of the sky. Some of the results can be viewed on 
YouTube at magpi.cc/meteotuxyt. “I’m really 
happy with the results so far,” says Jippo. 


Cheap All Sky Camera 


MagPi 


The project cost 
just $150 to build 


It includes a 
180-degree lens 


Two Raspberry Pi 
computers 
are used 


The project runs 
Meteotux Pi: 
meteotuxpi.com 


It takes a 
series of long- 
exposure shots 


Jippo says the project 
can be compared with 
commercial all-sky 
cameras costing as 
much as $10,000 





Warning! 
Mains Electricity 


This project makes use 
of mains power, so be 
extremely careful and 

read this advice: 





magpi.cc/electricalsafety 
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ring Machine 
emonstrator 





ark 2 (TMD-2 


A modern-day Turing machine that's simple to use and understand. 
Nicola King marvels at this mathematical model of computation 





Michael Gardi 


A retired software 
developer, living in 
Waterloo Ontario 
Canada with his wife, 
who appreciates 
having the time to 
make whatever the 
heck he damn well 
feels like! 


magpi.cc/tmd2 


The computations are 
shown on screen, with the 
‘tape at the top moving 
left and right to read and 
write zeroes and ones, as 
determined by the table 
of instructions 


LOAD SAVE SCAN 


Ss many will know, Alan Turing was a 
A pioneering mathematician who created 

the renowned Turing machine in 1936, 
and is considered by many to be the father of 
modern computer science. Essentially, a Turing 
machine mathematically models a mechanical 
machine that operates on a tape. Over the years, 
others have developed their own iterations of this 
iconic machine. 

Ontario-based Michael Gardi is one such maker 
who has now created two versions of his Turing 
Machine Demonstrator (TMD). Acknowledging 
that there are some other great implementations 
out there, he wanted to maintain a focus on the 
real purpose of a Turing machine. “In my humble 
opinion, the complexity of these excellent and 
imaginative solutions often detracted from the 
understanding of what a Turing machine actually 
does,” he tells us. “For TMD-1, my goal was to 





18. | magpi.cc | Turing Machine Demonstrator Mark 2 (TMD-2) 


demonstrate the idea of a Turing machine with 

as much clarity as possible. I wanted to builda 
machine that was simple to program and easy to 
understand. I was really happy with the way that 
TMD-1 turned out. I believe it met the stated goals 
of ‘simple to program’ and ‘easy to understand’. 
To help accomplish those goals, the machine itself 
was limited to three states / three symbols, anda 
small ten-cell bounded tape.” 


The next level 
With the first model under his belt, Michael then 
decided to create a version with more potential 
depth for the Turing machine enthusiast, and 
TMD-2 was born. “For TMD-2 I wanted to ‘up the 
ante’,” he says. “My goal was to make a six-state 
/ six-symbol machine with a large 100,000 cell 
tape. As much as possible, I tried to bring forward 
the simple-to-use, easy-to-understand principles 
from TMD=1,” 

His TMD-2 makes use of a Raspberry Pi 3, 
an Official 7-inch Touch Display for the user 
interface, and a Camera Module mounted on an 
articulated arm above a ‘State Transition Table’ 
box. The latter can hold one of a selection of table 
cards 3D-printed by Michael, along with a set of 
alphanumerical tiles to place on them. The camera 
scans the current state of the machine, which is 
read using the Tesseract OCR (optical character 
recognition) library. The resulting computations 
are then shown on the Touch Display. 


Python program 

“At its heart, TMD-2 is a standalone program 
written in Python,” says Michael. “If you just want 
to try the application, it will run on any computer 
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1 For TMD-2, | wanted 
to ‘up the ante’ @ 


that supports Python (which is most machines). 
Running it on a Raspberry Pi is extremely easy, 
since both Python and the Pygame library it relies 
on are already part of the Raspbian [now Raspberry 
Pi OS] distribution.” 

While Michael has had some great feedback on 
TMD-2 following his posts on Hackaday, Hackster, 
and Instructables, he says, “Unfortunately, with 
the Covid-19 restrictions here I have not been 
able to show these projects to friends at my local 
makerspace (kwartzlab.ca) which is where | 
would normally get the best feedback (both good 
and bad!). My son and daughter-in-law worked 
through the Quick Start Guide for TMD-2 and 
‘programmed’ some of the challenge exercises. 
They are both avid gamers and said that it was a lot 
of fun, ‘like a game’.” 

Michael’s TMD-2 is a truly fascinating make 
based on a seminal invention that, arguably, laida 
solid foundation for development of the computers 
that we use today. What could be more inspiring? 
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> The project 
involved around 
50-60 hours of 
3D printing... 


> ..wWwhich mainly took 
place overnight 


>» TMD-2 took 
Michael around two 


months to develop 


> It was his first 


Raspberry 
Pi-related 
development 
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code at magpi.cc/ 
tmd2code 


“ Mounted onto the 
back of the State 
Transition Table box, 
the articulated camera 
arm is a design by 
Chris Rogers 
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Kris Vanherle 


Kris is the technical 
coordinator of the 
WeCount project. 
He works on the 
development of 
the technology 
used for the 
website, analytics, 
and sensors. 





Enda Hayes 


Enda is a professor 
of Air Quality 

and Carbon 
Management at the 
University of the 
West of England. 
He leads the Cardiff 
project, and has 
funding for 150 
sensors in total. 





Dr Peter | 
Papics 


Peter is a data 
scientist working 

for Transport and 
Mobility Leuven. He 
wrote large parts of 
the scripts which run 
on the Raspberry Pi 
computers, and API 
and server code. 
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WeCount 


Traifiic Sensors 


Citizen scientists are helping researchers to monitor traffic data in six 
European cities and it's thanks to Raspberry Pi, gs David Crookes discovers 


well a city’s streets are being used. They need 

to know how many vehicles are being driven 
past a particular point, what type are they, and how 
fast are they going in order to learn more about 
traffic flow. 

Rather than have someone stand on the 
pavement and count manually, however, planners 
use technology. Some expensive solutions are 
limited to a narrow Set of locations such as 
highways but, in the case of the WeCount project, 
an affordable solution has been found with the 
help of Raspberry Pi. 


t’s important for planners to understand how 


| A Each sensor involves the fitting of a 
Raspberry Pi Camera Module V2 
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WeCount invites members of the public to place 
a sensor in their homes, peering out of the window, 
allowing live traffic maps of neighbourhoods 
to be built. Engineering and emissions expert 
Kris Vanherle says involving citizens results in 
ereater support for future traffic management 
implementation. “Data collection also becomes 
more affordable for local authorities and citizens 
can even help interpret the data,” he adds. 

In one instance, a spike in traffic was due to a 
temporary road block and this was reported by one 
of the citizens involved. WeCount is now being 
used in six European cities — Madrid, Barcelona, 
Dublin, Cardiff, Ljubljana, and Leuven — and the 
data collected is uploaded to the cloud so that it can 
be used within initiatives related to air pollution, 
safety, active travel, noise, and speed. 


Creating the sensors 

The sensors were originally built using Raspberry 
Pi 3B+ computers, but the production units make 
use of Raspberry Pi3A+. “These already provide 
the required processing power and memory 

and we found we did not need the extra ports 

of its big brother after the initial development 
phase,” explains Dr Péter I Papics, a researcher at 
Transport & Mobility Leuven. 

He says the project uses standard Python 
libraries combined with OpenCV for the image 
processing and object tracking algorithms. “We 
need to maintain the necessary frame rate, which 
is around 30 fps, to capture even the fastest cars 
over at least a few frames,” he continues. 

“So we are using the most simple background 
extraction and contour detection methods to 
find moving objects on each frame and then a 
tracking algorithm to identify and track them over 
their visibility period stretching across a set of 
consecutive frames.” 
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A Raspberry Pi operates as a wireless hotspot and 
it provides a simple user interface so that camera 
angles can be fine-tuned. “After ten minutes, 
the hotspot mode is automatically disabled and 
Raspberry Pi attempts to connect to the local 
WiFi,” says Péter. 

“Tf successful, the actual traffic monitoring 
Script is activated and various properties of the 
detected objects are periodically transmitted to 
our services where data processing, classification, 
and aggregation services produce the data that’s 
available on our website or via the public API.” 


Amassing the data 

The cities involved are enthusiastic. Prof Enda 
Hayes, from the University of the West of England 
in Bristol, says he was keen to include Cardiff A Raspberry Pi 3A+ is fitted 
because it has immeasurable potential for more inside each case and 

active travel. “The city’s inhabitants are very car- cee re “a lal 
dependent and the city experiences a large influx SET peeled STIL: 
of daily commuters, with the majority of these > They are working 
journeys — some 80 percent — by car,” he says. with local authorities 





> Researchers want 
150 to 250 sensors 
in each city 


™ We are using the most simple background extraction and ee en 
contour detection methods to find moving objects @ not revealed 


> The project 
will run until 
December 2021 


The sensor also allows for the counting of 
pedestrians and cyclists. “I delivered one toa 
volunteer who lived on a dead-end street and 
found out pedestrians and cyclists were using the 
street as an active travel rat-run to get to a local 
train station. He wanted to convert the street into a 
Low Traffic Neighbourhood.” 

Kris says the data also allows researchers to 
observe how traffic behaves if lanes are closed 
on adjacent streets and it’s been used to increase 
compliance to speed limits. “WeCount empowers 
citizens and anyone who wants to join can do 
because the platform is open,” he says. Hl 


> The data can 
be accessed at 
telraam.net 


Kris Vanherle and 
colleague Giovanni 
Maccani work on the 
production of a sensor 
device which is housed 
inside an expensive 
casing made by TEKO 
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Jazz Champion 


This unusual upcycling project transforms a vintage chess machine 
into g musical game, Phil King thinks, “Jazz... nice!" 








Leo Neumann 


Leo is a computer 
scientist and 
audiovisual 

artist. His work 
investigates the 
connections 
between sound, 
light, science, 

and technology. 
Essentially, he likes 
to bang on things 
he encounters 
around him. 


tonlicht.studio 


> It took a couple of 


attempts to get the 
3D-printed base design 
right and align the LCD 


under the tinted window 


f someone were to give you an old chess 

machine that didn’t work, what would you 

do with it? Turning it into a musical game 
involving chord progressions probably doesn’t come 
to mind, but that’s just what jazz fan Leo Neumann 
has made from a1978 Chess Champion MK1. 

“The inside was completely missing with the 
exception of a beautiful keypad,” he recalls. While 
he wasn’t sure what to do with it at first, and it 
eathered dust for a couple of years, a conversation 
with a friend about converting trash objects into 
musical instruments sparked an idea. “It suddenly 
clicked: I would turn the chess computer into a 
jazz computer!” 

Leo noted a striking resemblance between the 
notation of chords and chess moves. “For example, 
E6 E7 means in chess that a pawn moves from 
square E6 to E7. In jazz it would describe E major 
chords extended by a sixth or seventh note,” he 
says. “Also, I much liked the idea that playing a 
chess game is akin to playing a duet in a call-and- 
response type of scenario.” 


A little knight music 

Leo says the musical game he created is very 
simple to play, involving pressing the machine’s 
buttons to choose chords. “You enter a jazz chord, 
wait two seconds while the computer comes up 
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A The inner workings include a Raspberry Pi Zero with 
\/M8 960 Audio HAT, speakers, and 176x220 LCD 


with a matching chord, and then it is your turn 

again. One can choose chords of any key and it can 
be major or minor, diminished or augmented, and 
possibly extended by 7th, 9th, 11th, or 13th notes.” 

The computer will then seek to come up witha 
chord that sounds as “cool as possible when played 
after the given user chord,” he reveals. “It does so 
by generating 1000 random candidate chords and 
using a metric to assess how well they fit. The best 
chord is taken and the computer score is increased 
by the value according to the metric.” 

Once the user has entered their chord, the same 
metric is used to add points to their score. “The 
game has no end - one can play as long as desired, 
since the main point is not to ‘win’ by scoring more 
points, but to just have fun playing jazz music.” 


Striking the right chord 


It took Leo around two months to develop the 
project, including replacing the chess machine’s 
original seven-segment display with a 176x220 
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Leo's software uses 
the Pyo library for 
sound generation 
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It was developed 


LCD to show longer chord names, and 3D-printing aa) Heo pte q Co D | OY é | | th C Leia 
' fine on Raspberry 

a new base to house a Raspberry Pi Zero, WM8960 Di Zero 
Audio HAT, and speakers. common chord combinations 

By the far the hardest part of creating the - Hie hate musical 
Python software was to design an algorithm cia d rate th eM Manud | ly ” project is 
that rates how well a new jazz chord follows a called Transit: 
given one. After trying several musical theory magpi.cc/transit 


approaches and finding that they didn’t come up 
with the desired “jazzy feel”, he opted to play all 
the common chord combinations and rate them 
manually — a process that took three days and was 
a “numbing experience.” 

“The ratings form the basis of the metric and 
I integrated some additional heuristics such that 
chords do not sound too dissonant, too consonant, 
too repetitive, nor too simple,” he explains. “I 
just underestimated how difficult it is to translate 
human artistic preference into computer code and 
learned a lot here.” 

As well it being a fun game to play, Leo thinks 
his Jazz Champion could double as a useful aid 
for composing jazz music, by generating chord 
sequences. “It is actually easy: one can just 
repeatedly input the last computer-generated 
chord to get an entire sequence! > A Allthe components required to convert a chess machine into a jazz music game 
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Santiago 
Rodriguez 


A seminar at Berlin 
Humboldt University 
introduced 21-year- 
old Spaniard 
Santiago to coding in 
Python for numerical 
physics, and kick- 
started his first ever 
Raspberry Pi project. 


magpi.cc/ 
hubblepigit 
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ubble P1 


A ‘Eureka!' moment at university led one student to 
retrofit his telescope with gn HO Camera sensor and 
aim it at the stars. Rosie Hattersley learns more 


hen physics student Santiago Rodriguez 
W learned about the possibilities of 

Python for numerical physics, he 
immediately recalled a conversation with a friend 
about a new product from Raspberry Pi, the High 
Quality Camera. 

This camera would work with Santiago’s beloved, 
but rather small, Maksutov telescope. Having been 
a huge fan since childhood of all things space- 
related, and with plans to study astrophysics 
and masters and PhD level, he suddenly saw how 
coding might just fit in... and the idea for Hubble Pi 
was born. 


< Astronomy programs such 

as KStars can be installed on 
Raspberry Pi to provide a map 
of the night sky 


Santiago’s goal was to use a Raspberry Pi 4 and 
HQ Camera to take pictures with his telescope of 
planets, stars, and maybe even DSOs (deep-sky 
objects). He also decided to load his Raspberry 
Pi with established astronomy programs such 
as KStars, which can display a live map of the 
night sky directly on the telescope using an 
attached display. 


Magic mirror lens 

He realised that the HQ Camera’s “bigger, exposed 
sensor would allow it to essentially use the 
telescope as a big mirror lens. It was quite cheap 
for the quality it could offer.” For controlling the 
sensor for astrophotography, the flexible, open- 
source nature of Raspberry Pi appealed too. 


M™ He began by learning 
what the sensor could 
do from the HQ Camera 
documentation 


To achieve this, Santiago developed AstroCam, 
a Python GUI for controlling the camera for 
astrophotography. “Using it, I can control ISO, 
shutter speed, and exposure time (with some 
limitations due to the digital nature of the rolling 
shutter),” he explains. 

AstroCam can also take multiple exposures 
automatically, and capture RAW image files — both 
important capabilities for astrophotography. 


Hubble Pi features a Raspberry Pi 4 anda 
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The HQ Camera and the telescope's optics work 
really well together, with a readily available C-mount- 


The photos taken of the night sky to-telescope adapter connecting them seamlessly 


with Raspberry Pi’'s HQ Camera are 
comparable to those captured using 
a DSLR camera with the telescope rig 





Santiago set up 
his astro camera 
pointing out 
the window 


His friends thought 
he was spying on 
his neighbours 


mn Pointing the 
we telescope at the 
~s, sun without covers 
‘. was another howler 


~ But he does 

a recommend 
} : sharing your live 
photos with friends 


And even 


recommends it as a 
conversation starter 


Hubble Pi magpi.cc 25 





MagPi 





The Hubble Pi setup 
captured fantastic 
close-ups of the 
moon, including 
this one showing 
Mare Crisium 


Hubble Pi, named after 
the famous astronomer 
Edwin Hubble, was 
able to photograph 
distant planets, 
including Jupiter 










Hubble Pi can also 
work wirelessly or ds a 
Standalone if needs be 


Controls are triggered locally via a touchscreen, 
or through a remote desktop connection from a 
laptop connected via Ethernet or a wireless LAN 
hotspot hosted by Raspberry Pi. He was reasonably 
confident the project would work, having seen 
similar endeavours based around Raspberry Pi 3B. 

Santiago had never used Python before, so he 
began by learning what the sensor could do from 
the HQ Camera documentation, after which the 
main challenge was coding the GUI program with 
Tkinter and adapting it for his astrophotography 
needs. “I based my AstroCam script’s main loop 
and the image preview code on that of a Python 
programmer who had developed it for a normal 
camera use,” he says. The source is credited 
in the documentation in Santiago’s GitHub 
repository: magpi.cc/hubblepigit. 

Although others had posted similar projects 
on GitHub, no one had written about using 
the C-mount adapter for the HQ Camera for 
astrophotography at the time. Fortunately, 
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Assemble your rig 


01 You need a Raspberry Pi 3 or 4 with 2MB+, a 

touchscreen display, and a 32GB microSD 
card, plus an HQ Camera (sensor only), telescope, 
and 1.25-inch C-mount adapter. Power from a USB-C 
or a USB power bank. 





; A. Another moon shot, 
C-mount-to-telescope adapters are fairly showing Crater Tycho and 


common, and Raspberry Pi itself could simply be Mare Nubium 
mounted using a simple phone adapter. 


Shooting stars 

Santiago is reasonably pleased with the results 
from Hubble Pi. “Most good USB cameras for 
astrophotography start at about €200 and require 
a connected computer at all times. Hubble Pi can 
also work wirelessly or as a standalone if needs 
be,” he notes. 

Raspberry Pi 4 and HQ Camera sensor work 
very well, but photos are limited by the optical 
limitations of his telescope, while humidity and 
light pollution are also factors. “Planets and 02 Create a wpa_supplicant.conf file and empty 
stars look alright, but somewhat blurry without ssh file in Raspberry Pi's boot directory 
stacking (due to atmospheric distortion), and (instructions at magpi.cc/headless) so you can 
DSOs are very difficult to capture due to the f/14 eee ee a gee ene pul ceeal ie 

remote connections, use XRDP or a monitor and 
aperture ratio from the small Maksutov (brighter/ keyboard-mouse combination. 
bigger optics should deliver better results here),” 
discloses Santiago. 

“My friend’s DSLR doesn’t perform much better 
when attached to my telescope at prime focus,” he 
says. “The only real limitation from the sensor side 
of things is its digital rolling shutter, which means 
it can’t do hour-long exposures like DSLRs.” But 
an expensive star tracker (to compensate for the 
drift during the lengthy exposure) costs upwards 






of €300. 

When finances allow, santiago intends to | , Conneck cun@reamesenclencpicine 
develop Hubble Pi in this direction. For now, he’s camera (see magpi.cc/picameraz2), then mount 
pretty pleased with his first Raspberry Pi project. the telescope and take some test shots by typing 
“This may have been the first, but it certainly raspistill -o Desktop/image. jpg into a Terminal. 


won’t be the last!” Hl 
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RIT Jam 


Real-time music jams with friends, with a little help from Raspberry Pl, dre 
gq great way to keep in touch. Rosie Hattersley hears one musician's story 





Mike Vargo 





California-based 
engineer and 
musician Mike 
previously used 
Raspberry Pi ina 
HearSee project to 
create an ultrasonic 
sound map. 


magpi.cc/rtjam 


» The Scarlett 2i2 mixer 


Vargo was exploring options for how to 

set up real-time music jams with his 
friends when fellow musician Darius Mostowfi 
introduced him to Raspberry Pi. He’d already tried 
out several hardware and software options, but 
once Mike realised that Raspberry Pi OS was simply 
a Debian distro, things slotted into place and RT 
Jam began to take shape. 

“T was familiar with Voice over IP (VoIP) from 
previous experience and decided to try to build 
something with latency low enough to allow you 
to play as a group online,” says Mike. “When | 
saw that Raspberry Pi OS was just another Debian 
distro, I realised my laptop Linux code would 
compile and run on the Pi.” 


- ngineer and Linux enthusiast Mike 


Low latency 

To work properly, RT Jam would need a person- 
to-person latency of less than 25 milliseconds. “1 
was leery of a peer-to-peer product because of the 
many issues with network firewalls, so I decided 
to opt for a client/server type structure,” Mike 
explains. However, “large variances” in sound, the 
input-output performance on Linux, Windows, 
and macOS made a software-only solution “very 
troublesome”’, he says. “Raspberry Pi gave me a 
turnkey solution.” 


Scarlett Biz 


provides 24-bit audio support 
for the musicians involved in 
an online jam 
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Mike realised his 4GB Raspberry Pi 4 could be also 
used to run the broadcast server, including NGINX 
(nginx.com), and applauds the ability to install so 
many standard packages so easily. “Compiling the 
code on Raspberry Pi was very straightforward.” 


Sound and vision 

Before he began working on RT Jam — he 

describes the “want level” as a silver lining born 
of necessity — Mike had tried out Raspberry Pi 

for a putative HearSee project (also on GitHub: 
magpi.cc/hearsee) in which ultrasonic range 
sensors on a handheld stick convert distance 
readings into a sound form that would allow you to 
‘see’ with your ears. That project is on hold, but it 
acted as an excellent demonstration of Raspberry 
Pi sensors’ capabilities. “Raspberry Pi worked 
ereat for hooking up the sensors and creating 

the sound,” he says. However, low-latency audio 
would work with Raspberry Pi only when using a 
USB 2.0 device for both input and output. He chose 
a Focusrite Scarlett controller, which he loves for 
its aesthetics as well as its performance. 

Mike began by using DISTRHO/DPF, a software 
framework for audio plug-ins, using which he was 
able to program all the audio I/O via jack. He had 
help from falkTX (magpi.cc/falktx) who had been 
working on this framework for some time. 








i 


The RT Jam control screen 
allows up to five musicians 
Kom o)k=\ a Kolet~1sal-] am IL <omsvole) a 
hopes to increase this to seven 


Alt 
Mike was impressed to 
discover the jack configuration 
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2.66 millisecond latency 


The Focusrite 
hYor= la lclamece)alage)ilcie 
takes care of audio 
TaleleimclaleMelelveleimrela 
the RT Jam setup 


Once Mike realised that Raspberry P! OS was simply a Debian distro, 
things slotted into place and RT Jam began to take shape 


The design for the VoIP elements was Mike’s 
own. “I have done this kind of stuff before, so it 
was not too hard,” he says, “but I had not written 
any C++ code for 20 years, so I was a bit rusty. I’m 
sure if somebody looks at the code (it’s open- 
sourced), they will find lots of things to laugh at!” 

One of the challenges was to get Raspberry Pi’s 
touchscreen working right and to figure out the 
settings for real-time audio. Once he was happy 
with everything, Mike simply copied it allasa 
microSD image. 

He’s keen to develop RT Jam, adding capacity for 
more musicians to jam along. “I also want to hook 
up an Icecast feed from the server, so even people 
who don’t have the software can just listen to a live 
broadcast of the room feed.” 
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RT Jam is powered by 
Raspberry Pi 4, while 
mixing controls are 
accessed via 

a touchscreen 


Mike loves being 
able to jam with 
his friends 


Coronavirus 
restrictions made 
him consider 
remote options 


Although he's an 
engineer, Mike says 
he's still terrible 

at soldering 


Virtualjamming Is “a 
little different than 
in person’... 


But listening to what 
other people are 
playing is still key! 


Mike's setup uses the 
Linux-based Ardour 
Mixer MIDI app 
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» FREE Delivery 
Get it fast and for FREE 


» Exclusive Offers 
Great gifts, offers, and discounts 


» Great Savings 
Save up to 35% compared to stores 


» Low monthly cost (from £5) 
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Free Raspberry Pi Zero W Kit with 12 Month upfront 
subscription only (no Raspberry Pi Zero W Kit with 
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Raspberry Pi Zero W 





Raspberry Pi a 

Zero W case with oh NG ea ae 
Spppipael-y he 

three covers a Leeee ca: 


USB and HDMI 
converter cables 


¥ 
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- Camera Module 
connector 


This is a limited offer. Not 

included with renewals. a ——— 
Offer subject to change or 

withdrawal at any time. 
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Coo BD Create the ultimate media box 
= using Just a Raspberry P1 
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built a lot of projects with one. Having several 

Raspberry Pi computers performing similar 
functions seemed a littler redundant to us, though, 
which gave us a brainwave - what if we could combine 
multiple uses into one amazing project? 

Thus we decided to see how many media Services we 
could squeeze into just one Raspberry Pi 4. Luckily, the 
majority of the tools are already available - you just 
need to know how to combine them all. Get ready for 
the perfected media experience. 


R aspberry Pi is capable of many things, and we’ve 
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Parts list 
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Everything you need to put together your ultimate media centre 





v Argon One M.2 


£42 / $45 | magpi.cc/argononem2 


A Raspberry Pi 4 


£34 / $35 | magpi.cc/raspberrypi4 


v Official Raspberry Pi 
4 power supply 


£8 / $10 | magpi.cc/psu4 






A Mini Remote Control 


£5 / $6 | magpi.cc/miniremote 


v Game controllers 





A HDMI cable 








< 16GB 
, microSD 
A Flirc USB card 


£20 / $23 | magpi.cc/flircusb 
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A M.2 storage drive 


> Ethernet cable 


t. 


ap 


qo 


& 






v Raspberry Pi 
| TV HAT 


| £20 | magpi.cc/tvhat 


< Wireless 
keyboard 


| > Removable 
USB storage 
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Build your media PC and install RetroPie 


PUT IT TOGETHER 


Install RetroPie 

We’re using RetroPie as it allows you 
to emulate several game systems, as well as 
installing Kodi under it for video and music. You’ 
need to burn your microSD card manually for this 
— we advise using Raspberry Pi Imager (download 
it from magpi.cc/imager). It’s easy to use: click 
‘Choose OS’, select RetroPie, then choose the 
‘RPI 4/400’ version for Raspberry 4 and 400. Then 
click ‘Choose SD card’, select your microSD card. 
Finally, click ‘Write’. 


Install Raspberry Pi 

We’re using the Argon One M.2 case fora 
few reasons — it’s secure, it keeps your Raspberry 
Pi cool, it can use a Nanosound DAC if that’s your 
thing, and it routes all the inputs to the rear of the 
case. Because it has all these bells and whistles, it 
does take an extra step to install. The instruction 


Raspberry Pi imager 


Operating System x 


Wy De ee 


RetroPie 4.7.1 (RPI 1/Zero) 
Turn your Raspberry Pi into a retro-gaming machine, 
Releqgce 0270-11-04 
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RetroPie 4.7.1 (RPI 2/3) 
Tum your Raspberry Pi into a retro-gaming machine. 
Released: 70! 


70-17-04 
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RetroPie 4.7.1 (RPI 4/400) 
Tum your Raspberry Pi into a retro-gaming machine. 
Released: 2020 Mar | 


assed: fUFU-1) 
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A Raspberry Pi Imager makes it easy to install 
RetroPie - choose the RPI 4/400 version 
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set up your system 


manual that comes with the Argon One shows 
you how to add the daughterboard to Raspberry Pi 
and then install it into the case with some screws. 
Follow these instructions, and keep the power 
button pins in the default position. 


Hook it up 
For first-time setup, we recommend 
connecting a USB keyboard, along with having it 
connected to a monitor instead of a TV for comfort 
— however, connecting it to your 
selected TV is also fine. If you 
also plan to use a wired game 
controller, connecting it now 
is also a good idea. The last 
thing to connect should be 
the power supply. 


INITIAL SETUP 


First boot 


With a power supply plugged in and 
switched on, press the power button on the back 
of the case to boot up your Raspberry Pi. RetroPie 
will do some initial automated setup stuff, then 
ask you to configure your games controller 


If you want 
to add an M.2 
SSD drive for 


Talelastelsx=1e ml alk=)aarele 
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CONFIGURING 


GAMIEPAL | 


HOUD AOR 15 10 SeP 


A Press the relevant buttons to configure your games 
controller; hold any button to skip a function 


moana gelule)\-Jalole)a ale) 
rela lo Ma] ossmelalsj el-xel ie: 
controllers, 
especially for Sony, 
Tel geysxo)a mare Vale! 
Nintendo consoles, 
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RetroPie 


CONFIGURE AUDIO SETTINGS 











CONFIGURE RETROARCH / LAUNCH RETROARCH RGUI id=) dae) ol (Mel ge MOL Of 
CONFIGURE RETROARCH KEYBOARD/JOYSTICK docs 
CONFIGURE RETROARCH NETPLAY 


CONFIGURE SPLASHSCREEN 





ENABLE/DISABLE DISPMANX SDL DRIVER FOR SDL1.X EMULATORS 
FILE MANAGER 
RASPBERRY PI CONFIGURATION TOOL RASPI-CONFIG 
RETROPIE-SETUP 
SHOW IP ADDRESS 










A Select the Configure WiFi option from the RetroPie menu and enter your network details 





buttons. If you don’t have a controller connected 
yet, you can press F4 on the Keyboard to get to 
the main menu. If you’ve run out of buttons to 
assign, hold down any button and it will skip the 
function. Keep doing this until you get to the end, 
and confirm ‘OK’ to finish. 

If you’re using a wired network and controllers, 
you can stop here! Just add ROMs over the 
network or via a USB stick to play games! 


M Make sure you turn the 
controller on just after 
the reboot @ 


Wireless connection 

If you don’t intend to use an Ethernet 
connection, you can connect to your wireless 
network in the RetroPie menu. Select ‘Configure 
WiFi?’ and it will open a text 
menu. Select ‘Connect to To 
WiFi’ and choose your 
network from the list. 
Enter your password and 
hit OK —- you may need 
to wait a moment or two, 
but it should then be 
fully connected. 


transfer 
ROMs over the 
ay) Ae) deme [em Ke) 
\\RETROPIE in the 


Windows File Explorer, or 
smb://retropie on Mac, 
Yale Me) el-1amelemaar= 
roms folder 








Stream from Steam 


RetroPie allows you to use Steam Link 
So) Aol n= mKOMsiNg=tolaamel-laal=\omace)eam-mel-laallale) 
=A@u-10r-1(61a]mxonvolelal MVamrone (om salicyme lon comial= 


Go down to Manage Packages and choose 
Experimental Packages from it. In that list will 
be ‘steamlink’ - install it and it will then appear 


STEAM 


RetroPie menu and then RetroPie Setup. | | NJ Ke 
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Bluetooth controllers 


Press F4 and you’1l open the command line. 
From there, make sure Bluetooth is installed using 


the command: 
sudo apt install pi-bluetooth 


Type exit to return to the graphical interface. Go 
to the menu and select Bluetooth Configuration. 
Select Register and Connect Bluetooth Devices 
while your Bluetooth controller is in pairing 
mode, then select it from the screen and follow 
the pairing instructions. Once connected, you 
may need to reboot your Raspberry Pi before 
configuring the buttons — make sure you turn the 
controller on just after the reboot. 


Install Argon 
ONE software 


To install the fan 
control to the 
system, press 

F4 to get to the 
command line, and 
enter the following: 


curl https: 77, 
download. argon4Q. 
com/argonl.sh | 
bash 
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Go beyond games to stream your own medida files over a network 


Install Kodi overscan issues. Find them in the settings menu, 
Kodi is our preferred media centre software and be sure to give the name of the system an 
for watching video and playing music, and you can update if you want to as well so you can identify it 
install it to RetroPie. Once again from the RetroPie on your network. 


menu, go to RetroPie Setup and then Manage 

Packages, Optional Packages. From there you’ be 

able to install Kodi — although it may take a while. 

Once installed, you’ll find it in the Ports menu as Add networked sources 

an option after a reboot. The easiest way to access media (videos, 
music, or pictures) over your local network is 
to add them as media sources. Head back to the 
settings meny from the top of the interface. From 


Setup Kodi there, go to File Manager and select Add Source. 
Kodi will be automatically set up after You’ll be able to browse your available networked 
installation, however you may want to change machines, or alternatively write in 
some settings, especially if you’re experiencing the SMB route if you know it. 
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| TV shows 
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Radio 
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Pictures 
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With the 


settings configured 
for the app, you'll also 
be able to control Kodi 
from your browser. Find 
out more here: 
magpi.cc/kodiweb 





yet Vamelshiale 
remotes 
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devices, and there's an official app for it as well, 
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you ll need to tell Kodi to allow you to use it. 
From the Settings menu, go to Services and find 
dal m@ve)aldce)me)o)i(olaMmm colanmsalicmicimmy elem cclalmcemaclaa 
Malo mce)ake)wdlale me) ©) dlo)alsmKom@)\ Hay Nike)wm e)geleleclaniome) a 
fo} dal=)aes)Vs)K=) 00 sm Kom exe) alice) ml Corel ay AN I Ke)\wmere)alace) Mei 
Kodi via HTTP’, and ‘Announce these services to 
other systems. 


@Jel-Jamdalow-|0)om-laremycelemsialelelkemel-w-lolK-mkems\-1K-lel8 
Malem arclaatomicelemel-\VA-melelal Corelms(-180) om ace)aamualomiicis 
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The first time you start 
Kodi, you'll have to do 
q basic setup 


With a Raspberry Pi TV HAT, you can watch and record TV using Kodi. You 
can have it streaming TV via a different Raspberry Pi if you don't have an 
aerial socket near your home theatre, or have it as a server and viewer 
from the same device. We have a full guide you can find here: 
magpi.cc/tvhatguide. 


The system uses Tvheadend to configure it all. 
You'll need to make sure you have a decent 
amount of storage attached if you 
plan to record TV. 







A Raspberry ss 
Pi TV HAT - 
enables you 
to watch and 
record digital 
terrestrial TV 
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Get streaming services and TV running on Kodi for the full smart TV experience 


Catch your 
favourite Netflix 
shows and movies 
on Kodi using a 
third-party source 


Netflix 


6.4 by libdev + jojo + asciidisco + 
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Netflix 


caphm + casta gnait 


Netflix VOD Services Addon 


Ce) 





INSTALL NETFLIX 


Get the source 

While Kodi doesn’t have an official Netflix 
add-on, you can easily add a third-party one 
that allows easy access to the streaming service. 
First of all, head to Settings and go to System. 
Scroll down to Add-ons and turn ‘Unknown 
sources’ to on. Go back and head to the File 
Manager — go to Add Source and enter the 
following address: 


https://castagnait.github.io/repository.castagnait/ 


Call it ‘netflix’ to make things easier. 


Install the add-on 

From the Settings menu, go to Add-ons 
and scroll down to ‘Install from zip file’. As 
‘netflix’ is now a source, you can select that to find 
a file called repository.castagnait-x.x.x.zip to 
download. Go back to Add-ons and go to ‘Install 


AWTO-L pc fate 


1 


Dey FEM ene be 





from repository’, where you’ ll find an option for 
CastagnalT Repository for Kodi. Select it, then 
Video Add-ons, and you’ll see the Netflix add-on. 
Go to install it, choosing the latest version, and say 
OK to extra stuff that will be installed. 


Go to Install it, choosing 
the latest version, and say 
OK to extra stuff 


Using Netflix 

You may need to add extra software for 
Netflix if you’re having issues. Exit Kodi, and press 
F4 in RetroPie to access the command line. Enter 
the following: 


sudo apt install python3-pip 
pip3 install cryptodome 


sudo apt install libnss3 


Head back to Kodi and Netflix should launch. 


Uyreidiat) Spotily Music 
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INSTALL SPOTIFY 


Spotify source 

There isn’t an official Spotify app on Kodi, 
so you’1l need to install from a third-party source 
like with the Netflix add-on, although this one 
you’ll need to transfer from another computer. 
Head to magpi.cc/spotifykodi on a computer and 
download the zip file from the link under ‘Install 
with repository’. If you’re able to transfer it to 
your media PC over the internet, do so, or load it 
to a USB stick and plug it into the media box we’ve 
been building. 


Install source and add-on 

Like with Netflix, head to Settings, Add- 
ons, and ‘Install from zip file’. Head to the folder 
you downloaded it to, or go through the USB 
storage you’re transferring it with to find the 
zip file. Head to ‘Install from repository’ and go 
to Marcelveldt’s BETA repository. Go to Music 
Add-ons and then install the Spotify app from 
there. If you’re having trouble installing, you may 
need to disable the Netflix add-on and restart. 
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Listen to your favourite tunes with an 
unofficial Spotify add-on for Kodi 


Install YouTube 


UT altl coms) ore) tiavarelalomN(=18i 0) emsalismelal-misw- Moll s 
easier — a YouTube app is available in the 
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Configure and use Spotify 

Use the Configure option from the screen 
where you installed the Spotify app and enter your 
Spotify login details. Once that’s done, head back 
to the home screen and you’|I find Spotify under 
the Add-ons menu. Open it to start browsing and 
listening — once again, it will use the standard Kodi 
interface instead of the usual Spotify one. 
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MagPi 


Raspberry P1 400 


Start your electronics adventure. Build your first circuits 





PJ Evans 


PJ is a writer, 
tinkerer, and 


software engineer. 


He has broken 
enough LEDs to 
light up Blackpool 
illuminations. 





gnd control them with code 


ou’ve got your new Raspberry Pi 400, 

admired its bright casing, and been 

amazed by the engineering that fitted 
so much power in a keyboard form factor. So 
now what? Well, there’s one thing that separates 
Raspberry Pi 400 from other desktop computers: 
its GPIO (general-purpose input and output) port. 
These 40 pins on the rear of the machine allow you 
to easily connect all kinds of sensors and indicators 
directly to Raspberry Pi 400 and then control them 
with code. If you’re excited by this but don’t know 
where to Start, this tutorial will guide you on your 
first steps into an amazing and rewarding world. 


' ai al-mC] (OM ole) am ice- Mere) (-\elde)a Ke) 
4 rollixc)a=val Mav, oX-s-Me) mexelaalaalelal(erclaceyal 
systems. Here, a Flat HAT Hacker 
is used to expand the GPIO pins, 
making them easier to access 





Set up safely 

Electronics is a delicate business. The 
components we are using are easily damaged, 
both physically and through being incorrectly 
wired up. The first thing to do is ensure you 
have a clean workspace. Carpets or anything 
that generates a lot of static should be avoided. 
Set up your Raspberry Pi 400 with a mouse and 
monitor. We’re going to be coding with Thonny, 


The GPIO pins will be 
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a simple yet powerful development tool provided 
with Raspberry Pi OS. You’! find it under 
‘Programming’ in the main menu. 


Introducing the EduKit 

The CamJam EduKit #1 is a fantastic 
Starter kit for those wanting to dip a toe into 
the world of building circuits. Rather than 
deluging you with a range of weird and wonderful 
components, this is a £5 selection of the absolute 
basics. It also comes with freely downloadable 
worksheets that go through a range of projects in 
satisfying detail. Inside you’ll find a breadboard, 
some resistors, a buzzer, LEDs, and cables 
to connect everything up. If you would like a 
detailed list of what is included, have a look 
here: magpi.cc/edukitiworksheets. 


™ The 40 pins on the rear of 
the machine allow you to 
easily connect all kinds of 
sensors and indicators @ 


Wiring up 

The breadboard supplied with the EduKit is 
used for prototyping simple circuits. Each column 
of points/holes is wired together to create rails 
SO we can use components to ‘bridge’ the rails. 
Additionally, there are four rails arranged in rows 
for easily supplying power. To safely connect the 
breadboard to your Raspberry Pi 400, the Flat HAT 
Hacker elegantly exposes the GPIO pins so that 
we can connect jumper cables between it and the 
breadboard. With the power off, connect the Flat 
HAT Hacker to the GPIO port. 











Introducing LEDs 

LEDs (light-emitting diodes) are cheap but 
fickle things. They must be placed the right way 
around and we must be careful with the amount 
of current they draw: too much and your LED will 
snuff out for good (it’s not dangerous, but can be 
frustrating). We solve this by placing a resistor 
in the circuit. It’s a component that reduces the 
current, a bit like squeezing a garden hose. We 
need the 330Q (ohm) resistors. Any higher and 


there won’t be enough current to light up the LED. 


Finally, have a look at the legs of the LED. The 
longer one is the positive side. If you put the LED 
in the wrong way around, it won’t light up. 
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All holes in this row are connected 


A breadboard is an 
essential tool for 
learning electronics. 
Here's how it is 
wired up 


Figure 1 Your first 
LED circuit. Be very 
careful with the 
wiring, especially 
the orientation of 
the LED 
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Pin1 


A Figure 2 Add a switch 
to control the LED 
using code 





Power off 


Although the voltages 
used are low and 
won't cause you any 
harm, a misplaced wire 
could be curtains for 
your computer. Power 
down before attaching, 
moving, or removing 
wires, and double- 
check everything before 
flicking the switch. 
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Power up 

Study our first circuit (Figure 1) carefully. 
As shown, use a jumper cable to connect a GND 
(ground) pin on the GPIO header to a hole in 

the ‘-’ row of the breadboard. This forms a 
‘sround rail’ that goes along the entire row so 

we can easily create a circuit. Now make another 
connection between pin GPIO18 on the GPIO 

and one of the columns as shown. Later on we’11 
switch the pin’s 3.3 V electrical current on and off 
by code. To protect the LED, add a 330 Q resistor 
between the ground rail and a different column. 
Finally, bridge the two columns with the red LED, 
making sure the longer leg is not on the resistor 
side. Check and double-check your work. 





Just add code 

Once you’re Satisfied that everything is 
connected correctly, boot up your Raspberry 

Pi 400 and start Thonny from the Programming 
menu. Carefully enter the code in led.py. This 
uses a library (a collection of things to help you 
do stuff easier) called GPIOZero, which takes a lot 
of complexity away from talking to the GPIO. The 
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Pull up, or down, pins? 


Not all GPIO pins are the same. By default, the 

first eight GPIO pins on Raspberry Pi are set to 
pull-up, while the rest are set to pull-down. With 

a pull-down pin, like GPIO 25 used for our button, 

it is a‘o’ when the button is not pressed, a ‘1’ when 
the button is pressed, and will return to ‘0’ when 
released. Some circuits use a resistor connected to 
the button. With a resistor, it doesn't matter if the 
pin is pull-up, or pull-down. If you are having trouble 
with a button in a circuit, try adding a resistor, or use 
a different GPIO pin. You can adjust the default GPIO 
pin behaviour using the config.txt settings. See 
magpi.cc/gpiocontrol for more information. 


code configures pin GPIO 18 to be an output (we 
can send current out when we want to) and then 
sets it to ‘on’, which means we are sending the 
current. After five seconds it turns the LED off 
again. The print() commands let us know what 
is happening in the Shell at the bottom. Save the 
led.py file to your home directory and then run it 
using the Run button. Does the LED light up? If 
not, check your circuit and code carefully. 


07 On the blink 

Now you have successfully illuminated your 
LED, let’s do something a little more fun. Change 
the code to that shown in led_blink.py. Run it and 
see what happens. Blinking! Click the Stop button 
when you’re done. Can you change the speed of 
the flashes? 


Getting some input 

As well as sending output, Raspberry Pi’s 
GPIO header can read input from a large range 
of components. These can include switches, 
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DOWNLOAD 
THE FULL CODE: 


yy) magpi.cc/electronics400git 
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Pin 1 >» Language: Python 3 









A Figure 3 Practise your Morse code with a buzzer and switch 


Q01. import time 
Q0@2. from gpiozero import LED 


003. 
temperature, pressure and light sensors, and Q04. red = LED(18) 
much more. As you may have seen from the code, 905 


we can assign some (not all) of the GPIO pins to be 
either an input or output. This allows us to read 

in information from a sensor, make a decision 

in code about what to do and then, if we wish, 
instruct an output device. So let’s start by simply 
switching on the LED when a button is pressed. 


Q@06. print("LED on") 
Q@07. red.on() 

Q08. time.sleep(5) 
Q@09. print("LED off") 
red.off() 





M As well gs sending output, led_blink.py 
Raspberry Pi's GPIO header 
can read input from a large 


range of components 





» Language: Python 3 


Q01. import time 
Q02. from gpiozero import LED 


003. 
Q0@4. red = LED(18) 
Press to play Q05. 
In the EduKit there is a tactile switch. 006. print("Blinking the LED") 
Like the LED, these can bridge the columns of eine 
Q08. while True: 
the breadboard, only making a connection when 
; Q09. red.on() 
the button is pressed down. With your Raspberry 010 cineeleeae) 
Pi 400 off, wire everything up as shown in pai. Red off() , 
Figure 2. You should have a connection between 012. time.sleep(0.5) 





the switch and pin GPIO 25 and also the ground 
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Pin1 


led_button.py 


>» Language: Python 3 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010; 





from gpiozero import LED, Button 
from signal import pause 


red = LED(18) 
button = Button(25) 


button.when_pressed = red.on 
button.when_released = red.off 


pause() 


buzzer.py 


>» Language: Python 3 


001. 
002. 
003. 
004. 
905. 
006. 
007. 
008. 
009. 
010. 





from gpiozero import Buzzer, Button 
from signal import pause 


bz = Buzzer(21) 
button = Button(25) 


button.when_pressed = bz.on 
button.when_released = bz.off 


pause() 
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< Figure 4 Add more 
LEDs to create a traffic 


rail. Power up and add the led_button.py code: 
When you run it, the LED should only light up 
when the button is pressed. Can you change the 
code so the opposite is true? 


Make some noise 

Here’s an example of another type of 
output: sound. Included in the kit is a simple 
buzzer. The longer leg is the positive end, 

just like the LED. Connect the buzzer to two 
separate columns on the breadboard and, using 
jumper cables, connect the short leg column 

to the ground rail and the long leg column to 
pin GPIO 21, as in Figure 3. Change your code to 
buzzer.py. Run the code and when you press the 
button, you should hear a satisfying buzz. Can you 
add to the code to make a buzz and light up the 
LED at the same time? 





™ Now we have three LEDs, a 
Dutton, and a buzzer, can 
you make g game? You can 
decide on your own rules 4 


Traffic lights 

There are plenty of GPIO pins to play with, 
so add two more LEDs wired to 330 Q resistors 
and the ground rail, with the positive side going 
to pins GPIO 23 and GPIO 24 (see Figure 4). You 
now have a set of traffic lights! Using what we’ve 
learnt about switching current on and off and 
timing, can you create the classic traffic light 
sequence when the button is pressed? (Stuck? A 





TopTip & 


GPIO Documentation 


The numbering of GPIO om 
pins is not in numerical REA Sa ee a te 
order. Also, pay close acerarenecmesertn inte 
attention to PIN1 and PIN4o 

on both Raspberry Pi 400 

and Flat HAT Hacker. More a 

information on GPIO can be 

found here: magpi.cc/gpio. 





solution is here: magpi.cc/electronics40ogit). 
Can you get the buzzer to make a pedestrian 
crossing sound? 


Now make a game 

A final challenge for you before you move 
on with your electronics adventure. Now we have 
three LEDs, a button, and a buzzer, can you make 
a game? You can decide on your own rules. How 
about having to press the button when green 
lights up? If you get it wrong, the buzzer sounds. 
You can use Python’s ‘random’ library to pick a 
random LED to light up (there’s an example at 
magpi.cc/electronics4oogit). Also, you can work 
through the free CamJam Edukit worksheets for 
a Closer look at how these circuits work. Put your 
imagination to work and have fun! HI 
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The GPIO pins on Raspberry Pi 400 


In this tutorial we're using a Flat HAT Hacker to make wiring up the GPIO pins 
easier. However, you can connect jumper wires directly to the GPIO pins on 
Raspberry Pi 400 just like on any other Raspberry Pi model. Make sure to use 
the correct pin numbers, by checking with this pin guide and look at the PIN1 
and PIN40 markings next to the GPIO pins on the back of Raspberry Pi 400. 

If you tilt Raspberry Pi 400 so the keyboard is facing towards you, the pins 
will be in the same position as the Flat HAT Hacker pins. Make sure you have 
Raspberry Pi 400 turned off when connecting and disconnecting wires. An 
interactive pinout guide can be found here: magpi.cc/ pinout. 











Raspberry Pi pin numbers (400, 4B, 3B+, 3B, 2B, Zero, At+, B+) 


© GPIO © Ground OQ 3V3 @ 5V ID EEPROM 
vanced use on 
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Beginners Guide 





The only guide you need to get 
Started with Raspberry Pi 


e Learn how to set up your Raspberry Pi, install an 


operating system, and Start using it 


e Follow step-by-step guides to code your own animations 
and games, using both the Scratch 3 and Python languages 


e Create amazing projects by connecting electronic 


components to Raspberry Pi’s GPIO pins 


Plus much, much more! 


How to use your 
new computer 


Buy online: magpi.cc/bgbook4 
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> Figure 1 Displaying 
the text in a window 


Create GUIs with Python: 
Spy name chooser 


Make an interactive GUI application 


o far in this series, you’ve learnt how 
to customise your GUI with a variety of 
different options. It’s now time to get 
into the really interactive part and make a GUI 
application that actually responds to input from 
the user. Who could resist pushing a big red button 
to generate a super secret spy name? 

Since you already know how to create an app, 
why not go ahead and create a basic window and 
add some text if you like? Here is some code to 
get you started, and this code also includes some 
comments (the lines that start with a #) to help 
you structure your program: 








# Imports --------------- 
from guizero import App, Text 


# Functions ------------- 


app = App( "TOP SECRET") 


pe WTO BEG sop esses saa 
title = Text(app, "Push the red button to 
find out your spy name") 


# Display --------------- 
app.display() 


Run this code and you should see a window with 
the text (Figure 1). 


Add a button 

Let’s go ahead and add a button to the GUI. Add 
PushButton to your list of imports so that you can 
use buttons. (Be careful to use a capital B!) 


TOP SECRET va xK 
Push the red button to find out your spy name 
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Figure 2 | 





the red button to find out your spy name 


Tell re! 


A Figure 2 You now have a button 


Underneath the Text widget, but before the app 
displays, add a line of code to create a button. 


button = PushButton(app, choose_name, 
text="Tell me!") 


Your code should now look like spy1.py. Run it and 
no button will appear, but you’ll see an error in the 
Shell window: 


NameError: name 'choose_name' is not defined 


This is because choose_name is the name of a 
command which runs when the button is pressed. 
Most GUI components can have a command 
attached to them. For a button, attaching a 
command means “when the button is pressed, run 
this command.” A GUI program works differently 
to other Python programs you might have written 
because the order in which the commands are run 
in the program depends entirely on the order in 
which the user presses the buttons, moves the 
Sliders, ticks the boxes, or interacts with whichever 
other widgets you are using. The actual command 
is almost always the name of a function to run. 


Create a function 
Let’s write the function choose_name so your button 
has something it can do when it is pressed. 

Look at your program and find the functions 
section. This is where you should write all of the 
functions which will be attached to GUI widgets, to 
keep them separate from the code for displaying 
the widget. Add this code in the functions section: 


def choose_name(): 
print("Button was pressed") 























[ rs ay 


Buran wis preseed pele cicennlee 
Push the red bumon to tind out your apy nee 


Tell pea! 





Figure 3 


A Figure 3 Text is output to the Shell window 


Your code should now look like spy2.py. The button 
will now appear (Figure 2). If you press the button, 
it may appear that nothing has happened, but if 
you look in your Shell or output window, you will 
see that some text has appeared there (Figure 3). 

Instructing your function to first print out some 
dummy text is a useful way of confirming that the 
button is activating its command function correctly 
when it is pressed. You can then replace the print 
statement with the actual code for the task you 
would like your button to perform. 

Inside your choose_name function, type a # 
symbol in front of the line of code that prints 
“Button was pressed”. Programmers call this 
‘commenting out’, and what you have done here 
is told the computer to treat this line of code as 
if it were a comment, or in other words you have 
instructed the computer to ignore it. The benefit 
of commenting a line of code out instead of just 
deleting it is so that if you ever want to use that 
code again, you can easily make it part of your 
program again by removing the # symbol. 


Add some names 

On anew line, add a list of first names. You can 
choose the names in your list and there can be as 
many names as you like, but make sure that each 
name is between quotes, and the names are each 
separated by acomma. A collection of letters, 
numbers, and/or punctuation between quotation 
marks is called a string, so we say that each name 
must be a String. 


first_names = ["Barbara", "Woody", 
"Tiberius", "Smokey", "Jennifer", "Ruby" | 


Now add a list of last names as well: 


last_names = ["Spindleshanks", "Mysterioso", 
"Dungeon", "Catseye", "Darkmeyer", 
"Flamingobreath" | 


Now you will need to add a way of choosing a 
random name from each list to form your spy 
name. Your first job is to add a new import line in 
your imports section: 


from random import choice 
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DOWNLOAD 
Spyl.py THE FULL CODE: 


>» Language: Python 3 


@@1. # Imports --------------- 
002. from guizero import App, Text, PushButton 





y) magpi.cc/guizerocode 


203. 

604. # Functions ------------= 
Qe@5. 

Q06. # App ------------------- 
@@7. app = App("TOP SECRET") 
208. 


Q@9. # Widgets --------------- 

Q@10. title = Text(app, "Push the red button to find out your spy name") 
Q@11. button = PushButton(app, choose_name, text="Tell me!") 

Q12. 

Q@13. # Display --------------- 


app.display() 


spy2.py 


> Language: Python 3 


@01. # Imports --------------- 
002. from guizero import App, Text, PushButton 


203. 

604, # Functions <4+6¢222cceccc 
Q@5. 

Q06. # App ------------------- 
@@7. app = App("TOP SECRET") 
208. 


Q@@9. # Widgets --------------- 

Q@10. title = Text(app, "Push the red button to find out your spy name") 
@11. button = PushButton(app, choose_name, text="Tell me!") 

Q12. 

Q@13. # Display --------------- 

Q@14. app.display() 


This tells the program that you would like to use 

a function called choice which chooses a random 
item from a list. Someone else has written the code 
which does this for you, and it is included with 
Python for you to use. 

In your code for the choose_name function, just 
below your lists of names, add a line of code to 
choose your spy’s first name, and then concatenate 
it together with the last name, with a space in 
between. Concatenate is a fancy word that means 


Big red button. 


At the moment, your button is not big or red! You used properties in part one 
of this tutorial series to change the appearance of your text on the ‘Wanted’ 
poster, So can you use the properties of the PushButton widget to change the 
background colour and the text size? 

Note that it may not be possible to change the colour of a button on macOS, 
as some versions of the operating system will not allow you to do so, but you 
should still be able to alter the text size. 
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Spy3.py 


>» Language: Python 3 


0e1. 
0@2. 
0@3. 
004. 
Q@5. 
006. 
007. 
008. 


0e9. 


010. 
011. 
012. 
013. 
014. 
Q15. 
016. 
O17. 
018. 
019. 
020. 
021. 
Q22. 
Q23. 


# AMPOPUS =-s-ssse5e4s=4- 
from guizero import App, Text, PushButton 
from random import choice 


# Functions ------------- 
def choose_name(): 
#print("Button was pressed") 
first_names = ["Barbara", "Woody", "Tiberius", "Smokey", 
"Jennifer", "Ruby" ] 
last_names = ["Spindleshanks", "Mysterioso", "Dungeon", 
"Catseye", "Darkmeyer", "Flamingobreath" ] 
spy_name = choice(first_names) + " ° 
print(spy_name) 


+ choice(last_names) 


# App ------------------- 
app = App("TOP SECRET") 


# Widgets --------------- 

title = Text(app, "Push the red button to find out your spy name") 
button = PushButton(app, choose_name, text="Tell me!") 

button.bg = “red” 

button.text_size = 30 


# Display --------------- 
app.display() 


03-spy-name-chooser.py 


>» Language: Python 3 


0e1. 
0@2. 
0@3. 
004. 
Q@5. 
006. 
007. 
008. 
0e9. 
010. 


011. 


012. 
013. 
014. 
Q15. 
016. 
017. 
018. 
O19. 
020. 
Q21. 
Q22. 
023. 
024. 
Q25. 
026. 
027. 
028. 
Q29. 
030. 


# Imports --------------- 


from guizero import App, Text, PushButton 
from random import choice 


# FUNCLIONS =<ssseSs<s=se 


def choose_name(): 

#print("Button was pressed") 

first_names = ["Barbara", "Woody", "Tiberius", "Smokey", 
"Jennifer", "Ruby" ] 

last_names = ["Spindleshanks", "Mysterioso", "Dungeon", 
"Catseye", "Darkmeyer", "Flamingobreath" ] 

spy_name = choice(first_names) + " ° 

#print(spy_name) 

name.value = spy_name 


+ choice(last_names) 


app = App("TOP SECRET") 

# Widgets --------------- 

title = Text(app, "Push the red button to find out your spy name") 
button = PushButton(app, choose_name, text="Tell me!") 

button.bg = "red" 

button.text_size = 30 

name = Text(app, text="") 


# Display --------------- 


app.display() 
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Figure 4 


Toih he ned bu@on 6 ied cul oun ip nae 


‘join two strings together’ and the symbol in 
Python for concatenation is a plus (+). 


Mteey Sp eel acer 








A Figure 4 Outputting a spy name 


spy_name = choice(first_names) + + 
choice(last_names) 
print(spy_name) 


Your code should now resemble spy3.py. Save and 
run it. When you press the button, you should see 
that a randomly generated spy name appears in 
your console or Shell, in the same place where the 
original “Button was pressed” message showed up 
before (Figure 4). 


Put the name in the GUI 


That’s good, but wouldn’t it be nicer if the spy 
name appeared on the GUI? Let’s make another 
Text widget and use it to display the spy name. 

In the widgets section, add a new Text widget 
which will display the spy name: 


name = Text(app, text="") 


When you create the widget, you don’t want it to 
display any text at all as the person won’t have 
pressed the button yet, so you can set the text to 
"" which is called an ‘empty string’ and displays 
nothing. Inside your choose_name function, 
comment out the line of code where you print out 
the spy name. 

Now add a new line of code at the end of the 
function to set the value of the name Text widget 
to the spy_name you just created. This will cause the 
Text widget to update itself and display the name. 


name.value = spy_name 


Your final code should be as in 03-spy-name- 
chooser.py. Run it and press the button to see your 
spy name displayed proudly on the GUI (Figure 5). 
You can press the button again if you don’t like 
the name you are given, and the program will 
randomly generate another name for you. UI 






ee 











Push the red button to find out your spy name 





Woody Dungeon 





A Figure 5 The finished 
spy name chooser 
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Learn about event-based programming for your Python projects 
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Turn Raspberry P1 400 
into a legal Co4 emulator 


UK copyright law puts C64 emulation enthusiasts in a difficult position. This new 
VICE emulator fork replaces system files of unknown origin with official versions 








K.G. makes, writes 
about, and helps to 
preserve unusual 
gaming software 
and hardware. 


@KGOrphanides 


You'll Need 


> VICE 3.4 copyright 
compliant fork 
magpi.cc/vice 


> C64 Forever 
c64forever.com 





Warning! 
Copyright 


Only some C64 
games can be legally 
downloaded. See our 
Legal ROMs page for 

more information. 
magpi.cc/legalroms 


K.G. Orphanides 


computers, you’ll have noticed that the 

VICE emulator is nowhere to be found in 
Raspberry Pi OS’s software repositories. Unlike 
some emulators, which use clearly authorised or 
reverse-engineered ROM images of the original 
computers’ firmware, the ROMs included in VICE 
are ambiguously sourced, with little explicit 
licensing information. 

That’s a problem for anyone who wants to 

use VICE in the UK, as British copyright law is 
particularly stringent. Fortunately, almost all of 


f you’re a fan of Commodore’s classic 8-bit 


Raspberry Pi 400 doesn't 
support CRT displays, but 

AVA (@] SIS Z=11 Mo) odd aal ise. 

for full-screen play ona 

1 k=l alet=|ge me yJobsKelsfom aaleyalixe)s 
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Commodore’s firmware is legally available for free 
via current licence holder Cloanto. 

A fork of VICE 3.4, the most recent version of 
the emulator that runs smoothly on Raspberry Pi, 
has been created. This fork is stripped of any ROMs 
whose licensing status is unclear. It ships witha 
script to integrate Cloanto’s ROMs. 

This tutorial stands alone to give you a 
copyright-compliant C64 emulator on Raspberry 
Pi 400, but can also build on last month’s Spectrum 
emulation project, using the same GPIO joystick 
controller setup. 


BM allow elbli Ke Metsy--m daromst-laal=) 
1D) = yee) trol aero) alal=reake) a 
Valo molaiviclautal-|MUC-melelinmiels 
the Spectrum emulation 
project in issue 101 





Preparation 

If you followed last month’s tutorial in its 
entirety, you’ll probably want to undo the final 
step, which opens FUSE on boot. Delete or rename 
/home/pi/.config/autostart/fuse.desktop. 

Next, we’ll download Cloanto’s legal Commodore 
ROM set, C64 Forever (c64forever.com). It’s only 
available as a Windows MSI file. If you have a 
Windows PC, simply install it. 

If you have an x86-based Linux or macOS 
system, Wine 5.0 and above (winehq.org) includes 
full MSI file support, so you can similarly install 
that, run the installer from your file manager, 
locate your Wine prefix directory (~/.wine by 
default), and you’re good to go. Users of older 
versions Can open a command terminal and run: 


wine msiexec -i c64forever8.msi 


If Raspberry Pi is your only computer, you 
can use Box86 (magpi.cc/box86) to run an x86 
version of Wine; that’s an extensive emulation 
project in its own right, but the TwisterOS image 
(magpi.cc/twisteros) comes loaded with Box86 and 
Wine to make this a little easier. 


Locate your system ROMs 

C64 Forever Express is free and includes all 
the ROMs you’ ll need for most Commodore 8-bit 
systems, except the PET and the Co4 Direct-to-TV 
released by Ironstone. It also lacks Creative Micro 
Designs’ SuperCPU ROM, but our fork uses an 
SCPU64-compatible ROM created by the VICE team. 

After installation, you’ll find the ROMs in 

/users/Public/Documents/CBM Files/Shared/rom 
of your Windows system drive. Copy this directory 
over to Raspberry Pi. 





A. With pin-sharp controls, Sarah Jane Avory's award-winning 
Zeta Wing is a stunning example of the new wave of 
commercial C64 games 





VICE C64 - main menu 


futostart image 
Drive = 

Tape = 

Cartridge = 
Printer + 

Machine settings ~ 
Video settings - 
Tillis: et - soe 2 
Sampler settings = 
Snapshot + 

Save media file - 
Speed settings -* 
Reset = | 
Action on CPU JAM + 
Network 





Frame 


+ 
keyboard 


A full C64 Forever Plus licence ($15 / £11 from 
c64forever.com) includes extra features for 
Windows and Wine users, and it’s also the obvious 
choice if you wish to support Cloanto financially. 

Both versions include a collection of around 100 
games that Cloanto licensed from its developers and 
publishers, including Jack the Nipper, Stormlord, 
and Auf Wiedersehen Monty. Registered users will 
find the games on their Windows system drive at 
/users/Public/Documents/CBM Files/Games — copy 
that over, too, for later use. 


Get ready to build VICE 

We’ll be using a version of VICE 3.4 that 
includes no copyrighted firmware ROMs. It won’t 
build or work without ROMs, so we’ ll replace 
these using a script that ships with this fork. Ina 
Terminal, enter the following two commands: 


sudo apt install autoconf automake build- 
essential byacc dos2unix flex libavcodec- 
dev libavformat-dev libgtk2.@-cil-dev 
libgtkglexti-dev libmp3lame-dev libmpg123- 
dev libpcap-dev libpulse-dev libreadline- 
dev libswscale-dev libvte-dev libxaw7-dev 
subversion texi2html texinfo yasm libgtk3. 
cil-dev xa65 libsdl2-dev libsd12- 
image-dev 


git clone https://gitlab. 
com/mighty-owlbear/vice-3-4- 
copyright -compliant-uk.git 


Now copy the rom directory from ( 
C64 Forever into your unpacked | 
vice-3-4-copyright-compliant- 

uk directory. 


\ 


\ 


\ 
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A. VICE's menu is hugely 


comprehensive, but 
you ll mostly 
interact with its 
Machine, Drive, and 
Video settings 


TopTip & 


RTFM 


The VICE manual 
is a chunky but 
vital reference. 
Read it online 

at magpi.cc/ 
vicemanual. 


Physical games are 
still published for the 
C64, like this 5.25-inch 
floppy disk release 

of Dungeoneer’s 
Akalabeth port, 

but you need extra 
hardware to use them 
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A C64 Forever isa 
native Windows 
program, but both 
its free Express 
and paid-for Plus 
editions include fully 
licensed Commodore 
ROMs for use 
with emulators 


> Cinemaware's 
Defender of the 
Crown is one of a 
couple of games 
licensed for exclusive 
distribution by 
Kryoflux as a 
demonstration of its 
imaging system's 
handling of copy- 
protected C64 disks 





064 Forever Experess Edition 





Build and install 

The copyrom script supplied with this 
version of VICE looks for official ROM files ina 
directory called rom and copies and renames them 
as expected by VICE. Not all system ROMs are 
available; where this is the case, the script creates 
dummy files. If further ROMs are officially released, 
these can be replaced in an installed version by 
manually overwriting the files in usr/local/lib/vice. 


cd vice-3-4-copyright-compliant-uk 

./copyrom.sh 

. /autogen.sh 

./configure --enable-sdlui2 --without- 
oss --enable-ethernet --disable-catweasel 
--without-pulse --enable-x64 

make -j $(nproc) 

sudo make install 


Note that you have to build VICE --without-pulse, 
as above, for working audio. If you’d rather install 
VICE to a user directory, you can add --prefix= 
/home/pi/viceinstall_ 3.4 clean and run make 
install as a standard user, instead of using sudo. 
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Test VICE 
Although VICE includes several different 
emulators, we’re primarily interested in the C64. 
Two different C64 emulators are supplied: x64sc 
is more accurate, while the older x64 emulator — 
which we specifically built using the --enable-x64 
parameter above — is less CPU intensive, making it 
the best choice for Raspberry Pi. 

In the Terminal, we’ll create a directory for 
your C64 game collection, download Kryoflux’s 
authorised C64 release of Cinemaware’s Defender of 
the Crown, and use it to test the emulator. 





cd 

mkdir C64 && cd C64 

wget http://www.kryoflux.com/download/ 
DEFENDEROFTHECROWN. zip 

x64 


VICE should open with a blue window and an 
invitation to press F12. Do so, and marvel at the 
sheer number of configurable options available. 
Fortunately, we’ll only need a few of them. But let’s 
Start by loading that game... 

Press ENTER on ‘Autostart image’, browse to 
DEFENDEROFTHECROWN.zip, press ENTER, go 
down to the PRG file called "!"V-MAX! and press 
ENTER to load it. 


Configure inputs 

The GPIO joystick setup we built last month 
works perfectly with VICE 3.4, as will any USB 
joystick or joypad, but you’ 1] notice that it initially 
only works in the menus. 

Press F12 to open the menu. Go to Machine 
settings > Joystick settings > 
Joystick device 2. Press ENTER 
to select it, scroll down to 
Joystick at the bottom, and 
press ENTER again. 

Press left on your keyboard 
or joystick to go back up one 
level to the Joystick settings 
menu. Go down to ‘Joystick 2 
mapping’ and select it. Select 
each of Up, Down, Left, Right, 
and Fire in turn, and tap the 
joystick button you want within 
the five-second configuration 
period to assign it. 

If you accidentally assign the 
wrong button to one of these, 





use the keyboard to navigate back and reset it. Press 
ESC to return to your game. 

Note that most, but not all, single-player Co4 
eames default to using Joystick 2. 


07 Tweaking VICE 
VICE x64 works smoothly on Raspberry 
Pi 400, but you’ll want to delve into its settings 
menu to get the most out of it. 

First, go to Video settings > Size settings and 
enable Fullscreen. To provide a bit more screen real 
estate, go to Video settings > VICII border mode 
and select None. Test your setup again with your 
favourite game or demo. 

Getting rid of the border on a 19201080 display 
may result in some graphical overspill to the right- 
hand side on some programs that use unusual 
parallax scrolling tricks, but it’s a very minor and 
generally invisible issue. 

Once satisfied with your configuration, go to 
Settings management > Save current settings. 


Homebrew haven 

VICE supports vanilla PRG program files, 
Do4 disk images, CRT cartridge images, and 
T64 and TAP tape images, among others. As 
usual in these tutorials, we largely recommend 
modern C64 software, which is often distributed 
digitally, as the easiest way to get top-notch free 
and commercial games for your emulated retro 
system. You can find an itch.io C64 collection 
at magpi.cc/itchc64. 

Specialist publishers such as Psytronik 

(psytronik.itch.io), Double Sided Games 





> Published by 
Protovision, Lasse 
Oorni's MW Ultra 
is one of many 


(doublesidedgames.com), Protovision 
(protovision.itch.io), and BitmapSoft 
(bitmapsoft.co.uk) also continue to put out 
spectacular commercial games for the C64. 


Meanwhile, passion projects have seen authorised 


ports of games from other systems, such as 
Dungeoneer’s C64 version of Richard ‘Lord British’ 
Garriott’s Akalabeth (magpi.cc/akalabeth) and 
Double Sided’s release of L’ Abbaye Des Morts 
(magpi.cc/desmorts). 


Using C64 Forever’s RPS files 


If you wish to use the games that came with 
C64 Forever, you’ll have to rename them from the 
default RP9 extension. On Raspberry Pi OS, you can 
use the rename command-line tool for this. Drop 
the entire zip files into your C64 games directory, 
open a Terminal in the directory, and enter 
these commands: 


sudo apt install rename unzip 
rename -v 's/.rp9/.zip/' *.rp9 


Once renamed, you’ ll find that the zip files contain 
either Do4 disk images or T64 tape images. 
Extracting them makes it easier to distinguish one 
format from the other. 


unzip -o \*.zip 
rm *xml *.txt *.png *.zip 


Although many of the game files supplied are 
cracked versions, Cloanto makes it clear that 
licences to distribute the titles have been obtained 


from their original developers. Licensing details are 


provided in the Cloanto EULA. Wl 


modern C64 games 
to get both physical 
and digital releases 
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Demoscene 
conversion 


Demos show off 
the C64's sound 
and graphics 
capabilities. 
Try The Elder 
Scrollers from 
magpi.cc/ 
c64scrolls. 
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Buttons? Where's the fun in that? Why not trigger 
an event just by looking at a camera? 





«<> 


P) Evans 





wW @MrPJEvans 





PJ Evansisa 
developer and 
wrangler of the Milton 
Keynes Raspberry 
Jam. He runs a LoRa 
gateway, which is 
probably the nearest 
he’ll get to his own 
radio breakfast show. 


youu. NEED 


Raspberry Pi 4B 
hsmag.cc/RaspPi4 


Quality Camera 
hsmag.cc/ 


i 
€ Raspberry Pi High 
RaspPiHQC 


t's hard to comprehend how far machine 
learning has come in the past few years. 
You can now use a sub-£50 computer to 
reliably recognise someone's face with 
_ surprising accuracy. Although this kind of 
computing power is normally out of reach 
of microcontrollers, adding a Raspberry Pi computer 
to your project with the new High Quality Camera 
opens up a range of possibilities. From simple 
alerting applications ("Mum's arrived home!’), to 
dynamically adjusting settings based on the person 
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Add face recognition 
to your projects with 
Raspberry Pi 


using the project, there's a lot of fun to be had. Here's 
a beginner's guide to getting face recognition up 
and running. 


STEP ONE PREPARE YOUR RASPBERRY PI 
For face recognition to work well, we're going to need 
some horsepower, SO we recommend a minimum 

of Raspberry Pi 3B+, ideally a Raspberry Pi 4. The 
extra memory will make all the difference. To keep as 
much resource as possible available for our project, 
we've gone for a Raspberry Pi OS Lite installation 


*. 


lar-Tex-Me-\ecelelalii(eyal 
OT STale Maat-revaliat=y 
if=¥eTaal ale Meow ar-lae| 
work, so the latest, 
greatest Raspberry 
Pi 4 is a must 


The new 
Raspberry Pi 
a L@ Or: lealeters| 


gives a boost 
to accuracy 


with no desktop. Make sure you're on the network, 
have set a new password, enabled SSH if you need 
to, and updated everything with sudo apt -y update 
&& sudo apt -y full-upgrade. Finally, go into settings 
by running sudo raspi-config and enable the camera in 
‘Interfacing Options’. 


STEP TWO ATTACH THE CAMERA 

This project will work well with the original 

Raspberry Pi Camera Module, but the new official HO 
Camera will give you much better results. Be sure to 
connect the camera to your Raspberry Pi 4 with the 
power off. Connect the ribbon cable as instructed in 
hsmag.cc/HOQCameraGetStarted. Once installed, 
boot up your Raspberry Pi 4 and test the camera Is 
working. From the command line, run the following: 


raspivid -o test.h264 -t 10000 


This will record ten seconds of video to your 
microSD card. If you have an HDMI cable plugged in, 
you'll see what the camera can see in real-time. 
Take some time to make sure the focus Is correct 
before proceeding. 


STEP THREE INSTALL DEPENDENCIES 

The facial recognition library we are using is one that 
has been maintained for many years by Adam 
Geitgey (github.com/ageitgey/face_recognition). 


wT, 


These libraries can also 
identify ‘generic’ faces, 
meaning it can detect whether —— 


W 


a person is there or not 


It contains many examples, including Python 3 
bindings to make It really simple to build your own 
facial recognition applications. What is not so easy is 
the number of dependencies that need to be 
installed first. There are way too many to list here, 
and you probably won't want to type them out, so 
head over to hsmag.cc/FacialRec so that you can 
cut and paste the commands. This step will take a 
while to complete on a Raspberry Pi 4, and 
significantly longer on a Model 3 or earlier. 


STEP FOUR INSTALL THE LIBRARIES 

Now that we have everything in place, we can install 
Adam's applications and Python bindings with a simple, 
single command: 


sudo pip3 install face_recognition 


Once installed, there are some examples we can 
download to try everything out. 


cd 
git clone --single-branch https: //github.com/ 
ageitgey/face_recognition. git 


In this repository is a range of examples showing 
the different ways the software can be used, including 
live video recognition. Feel free to explore and remix. 


STEP FIVE EXAMPLE IMAGES 
The examples come with a training image of Barack 
Obama. To run the example: 


cd ./face_recognition/examples 
python3 facerec_on_raspberry_pi.py 


On your smartphone, find an image of Obama 
using your favourite search engine and point it at 
the camera. Providing focus and light are good, you 
will see: 

“| see someone named Barack Obama!" 

If you see a message saying It can't recognise the 
face, then try a different image or try to improve the 
lighting if you can. Also, check the focus for the 
camera and make sure the distance between the 
image and camera Is correct. 


STEP SIX TRAINING TIME 

The final step is to start recognising your own 

faces. Create a directory and, in it, place some 
good-quality passport-style photos of yourself or 
those you want to recognise. You can then edit the 
facerec_on_raspberry_pi.py script to use those Tiles 
instead. You've now got a robust prototype of face 
recognition. This is just the beginning. These libraries 
can also identify ‘generic’ faces, meaning It can detect 
whether a person is there or not, and identify features 
such as the eyes, nose, and mouth. There's a world 
of possibilities available, starting with these simple 
scripts. Have fun. O 
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Above @ 

Who are you? What 
even is aname? Cana 
computer decide 

your identity? 


QUICK TIP 


Don't worry if 

you don't have a 
Raspberry Pi High 
Quality Camera — you 
can use the original 
or any compatible 
USB camera. 


CODE 
hsmag.cc/GitHubFR 


ACK CREATE 


ace 


[make BuILO F 





HackSpace 


This tutorial is from 
HackSpace magazine. 
Each issue includes a 
huge variety of maker 
projects inside and 
outside of the sphere 
of Raspberry Pi, and 
also has amazing 
tutorials. Find out 
more at hsmag.cc 
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Mike Cook 





Veteran magazine 
author from the old 
days, writer of the 
Body Build series, 
plus co-author of 
Raspberry Pi for 
Dummies, Raspberry 
Pi Projects, and 
Raspberry Pi Projects 
for Dummies. 


magpi.cc/mikecook 


You'll Need 


>» One or more 
Trill sensors 
magpi.cc/ trill 


>» Make your own |2C 
expander or buy 
magpi.cc/trillhub 


Cheap Trills for all 


Use Trill Sensors to touch your life, and projects, thanks to Raspberry Pl 


he Trill boards began as a Kickstarter 
T campaign from Bela, an offshoot of a 

research team in the Centre for Digital 
Music at Queen Mary University of London. 
They started out with a highly optimised sound 
generating board for the BeagleBone Black board, 
and then developed the Trill sensors to accompany 
that system. However, they soon realised these 
little boards were useful for all makers, so let’s 
meet the Trills. This month we will look at 
communicating with the Trills, and then look into 
projects using them in the following instalments. 
They are normally designed to be attached to the 
Arduino class of boards, and also they can be used 
on a Raspberry Pi computer with a C++ program. 
But here, we will show you how to use Python with 
the sensors. 


What's a Trill 


Here at the Bakery, we can remember when 
Trill was a big brand budgerigar box of seeds, with 
constant TV advertising and the slogan ‘Trill makes 
your budgies bounce with health’. It also has the 
musical meaning of a rapid repeat of alternating 
notes. But here it is a touch sensor designed for 
adding to acomputer to input tactile information. 
They come in a variety of shapes: bar, ring, square, 
hexagon, and a DIY craft version. They can detect 
not only touch, but also multiple touches, and 
where on the tile they were made. 





Python 


It would be good if Trill sensors could be 
incorporated into a Python program, but there is 
no Python library to do this, which is why we wrote 
one. Bela had released an open-source C++ class 
to read them, so ‘all’ we had to do was to convert 
it into a Python class. This sounds a lot easier 
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to do than it was, but we eventually produced a 
very close replacement to the original C++ class. 
This allows us to write programs that use the Trill 
boards with the minimum of complexity, and ina 
simpler way than the original C++ class. 


Connector mix 

Each Trill board contains a powerful Cypress 
CY8C20XX6A/S microcontroller, preprogrammed 
to act as a touch sensor for the shape of board it is 
on. Even the source code for the microcontroller’s 
firmware is open-source. Each board, except the 
Trill craft, comes with Grove-style 12C connectors 
that finish in four individual male DuPont 
connectors. The Trill Craft board has a different 
connector to the other boards; this uses a right- 
angled row of pins, and the best way of connecting 
to that is to use a short length of four-way ribbon 
connector with sockets on both ends. 








Trill Type Default Address 
Bar Ox20 
Square _ Ox28 
Craft Cc) 0x30 
Ring Oo 0x38 
Hex eS 0x40 


A Figure 1 Default address for each Trill touch sensor type 


MagPi 


magpi.cc/pibakery 


This l2C expansion board 
FV hom xo) maa leia]| o)K-m efey-|ge(omKe) 
be hooked to Raspberry Pi 


All five different types ee 


of Trill touch sensor 





Connectors 

Figure 4 (overleaf) shows a photograph of 
our I2C expander board. Note how you can’t see the 
far end of each connector. This has a white mark to 
show you what way round to plug them. We used 
typing correction fluid because it dries quickly. 


The interface 

All Trill boards communicate over the [2C 
bus and have fixed address ranges, for each board 
type, in blocks of eight. So for five board types, that 
is 40 boards you could attach. Figure 1 shows the 
default address for each type of board, and Figure 2 


shows what solder links to make to the back of the 
board to change the default address. There could 
be nine of any one Trill type, but that reduces the 
maximum number of the next type to just seven. 
If that is not enough for you, then you can use the 
little utilised I2C bus oO, for another 39 Trills. 


Connecting the Trills 

The Trill boards need to be connected to 
the I2C bus. While Bela does sell a Hub to allow 
connection to ten boards, we decided to make our 
own. We made a nine-way I2C expander board, 
limited only by the longest length of stripboard 
we had to hand. We used a four-way DuPont pin 
header on the left, for connection to the GPIO pins, 
followed by a mixture of four-way DuPont pins or 
sockets (Figure 3, overleaf). Note that if you are 
using I2C bus 0, you will also need two 1K8 (1.8kQ,) 
pull-up resistors on this board, mounted end on. 


Default Address 


ADD1 


ADDO 





Default Address 
+4 


ADD1 


ADDO 





Default Address 
+8 


ADD1 


ADDO 





Default Address 
+1 


ADD1 


ADDO 





Default Address 
+5 


ADD1 


ADDO 





Default Address 
+2 


ADD1 


ADDO 





Default Address 
+6 


ADD1 


ADDO 





Figure 2 Changing the default l2C address on a Trill sensor 
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Default Address 
+3 


ADD1 


ADDO 





Default Address 
+7 


ADD1 


ADDO 





This is the default address for the next Trill type. 


So use with caution and check the next type, if fitted, 
does not have the default address. 
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1 Gnd 


Trill device connectors —-> 


3V3 Mark end 


1K8 


SCL Only required when using Bus 0 


GPIO Feed 


A Figure 3 Physical 
layout of the l2C 
expander board 


A Figure 4 
Photograph of |2C 
expander board 





Warning! 
I2C devices are 
not hot-pluggable 


Never make any 
changes in connections 
to the GPIO pins while 
power is applied to your 
Raspberry Pi. 


TopTip @ 
I2C bus driver 


The class library 
uses the simbus2 
driver. If not 
installed already, 
you need to type 
pip3 install 
Simbus2 ina 
Terminal window 
to install it. 





While you can plug the individual wires from the 
Grove connector into the sockets, you get a much 
more reliable connection if you glue them together 
into one strip (Figure 5). Plug them into a socket 
as the glue dries to make sure they are aligned 
correctly. Mark the connector with the black wire 
white, and match this to the white mark on the 
expander board. 


07 Connection to the GPIO 

All that is left to do is to connect the I2C 
expander board to the Raspberry Pi computer’s 
GPIO pins. Figure 6 shows this for using the 
normal 12C bus 1. We used an eight-way two- 
row connector and made a lead to connect to the 
pins at the left-hand side of the expander board. 
If you want to use I2C bus 0, Figure 7, then we 
recommend using a 32 by two-row connector 
over the GPIO pins, for ease of use. You could use 
individual socketed flying leads, but you would 
have to check the connections carefully every time 
you wanted to attach your I2C expander board. 





Testing the sensors 

On our GitHub page (magpi.cc/pibakery) 
you will find all the software. The class file is called 
trill_lippy and should be in the same directory as 
the program using it. As a first test, attach one Trill 
sensor, boot up, and load in the trill_testy file. Then 
uncomment one line that corresponds to your sensor 
shape. This creates an instance of the class using 
bus 1 at the default address, for that shaped board. 
Run this, then look at the numbers streaming out: 
see how they change as you touch the sensor. If you 
don’t see this then check your wiring. 
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Optional 
Pin header 
for Craft Trill 








Understanding the modes 

Each Trill can be used in a number of 
different modes, of which CENTROID is the most 
useful as this returns things like the number of 
touches detected, as well as their size and position. 
However, you can also access the data, under the 
hood, that makes up those values. The RAW mode, 
as its name implies, is the direct reading from each 
capacitive sensor. The BASELINE is the background 
reading from each sensor with no touches, and the 
DIFF mode is the difference between the raw data 
subtracted from the baseline reading. 


Visualising the date 

In order to help you visualise the data, we 
have written a program called graphic_trillion 
which lets you see the touch data on the 
background of the board’s shape. It first scans 
all possible Trill addresses on I2C bus 1 and 
compiles a list of all sensors found. Then the 
boxes for selecting that sensor type are enabled. 
Clicking on a sensor will select that type. If you 
click on a sensor and that sensor is already being 
displayed, but more than one sensor of that type 
is connected, then the next address of that sensor 
type will be selected. 


a 


—— 





Mark White 


— fe 


A Figure 5 Gluing floating connectors together 


Wiring for I2C bus 1 


eee Mark White 






Mark White 


4 way socket to 


I2C extender board 
Raspberry Pi GPIO 


A Figure 6 GPIO to 
l2C expander board 
connections to bus 1 


Wiring for I2C bus 0 





SCL 


4 way socket to 
I2C extender board 


Mark White 


28 






Mark White A Figure 7 GPIO to 
l2C expander board 


connections to bus O 


Raspberry Pi GPIO 


Options 

There are a number of options that can be 
tweaked to obtain more reliable or faster readings 
from the Trill sensor. Figure 8 shows the screen 
for a Square type, and you can see the touch. On 
the right-hand side, there are a number of options 
for setting up the sensors. These are best adjusted 
while looking at the readings in a data mode. 


™ The BASELINE Is the 
background reading from each 
sensor with no touches @ 


Then go back to the CENTROID mode to see what 
effects it has on the touch information. Figure 9 
shows the Trill craft in DIFF mode. Note here the 
individual sensors have been highlighted witha 
colour corresponding to each data reading. 


Grapnec Trl 


Figure 8 


rape Tnll 


Figure 9 


Python vs C++ 

We did a number of things differently in 

the Python class library to the original C++ library, 
mainly in the area of device discovery. Our take is 
that when you are doing a project, you know what 
sensors you have and what their address is. So we 
simplified the number of ways you could discover 
what devices were connected if you ever needed 

to do that. If an address of 256 and a Trill type of 
‘none’ is used, then the instance would not be fully 
initialised and verified, so you would have to do 
that ‘by hand’. The trill_scanty program illustrates 
this process. 





Finally 

Note that when using a two-dimensional 
sensor, like the square and the hex, it should be 
considered as a single touch sensor only. While it 
can detect multiple touches, it does so by working 
out the number of horizontal and vertical touches 
detected; there can be a different number of these, 
and it can’t pair them up. However, more advanced 
tracking algorithms could be devised for things like 
gesture recognition. 

So, now you have enough information to start 
using the Trill touch sensors. Next month we will 
see how to mount these sensors into a project, and 
look at some of the things you can do with them. I 
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Figure 8 A single 
touch on the Square 
Trill sensor in the 
CENTROID mode 


Figure 9 A double 
touch for a Craft 
Trill sensor in the 
DIFF mode 
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Sources 


You can also get 
Trill sensors from 
online retailers 
like Pimoroni, 
which might offer 
a faster service 
to your locality 
or, if you are 
buying something 
else from them, 
save on postage. 
See magpi.cc/ 
trillsellers. 
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RASPBERRY PI 


Take a dive into Raspberry Pi Pico and its brand-new 
custom-built RP2040 microcontroller. By Gareth Halfacree 


aspberry Pi Pico is a microcontroller board 

built on silicon designed by Raspberry Pi. 

Microcontrollers are computers stripped 
back to their bare essentials. You don’t use 
monitors or keyboards, but program them to take 
their input from, and send their output to the 
input/output pins. Using these programmable 
connections, you can light lights, make noises, 
send text to screens, and much more. 

The ultra-light, ultra-small Raspberry Pi Pico 
microcontroller board is ideal for embedding 
inside digital projects. Raspberry Pi Pico 
represents two major firsts for Raspberry Pi: 
it’s the first microcontroller development board 
from Raspberry Pi; it’s also the first device to 
use a Silicon chip designed by Raspberry Pi’s 
in-house Application-Specific Integrated Circuit 
(GANS)(@) Rixcr- bene 

Raspberry Pi Pico is a development board 
built around this powerful yet low-cost RP2040 i 

: Raspberry Pi Pico 
an blenmelero)elmme)elclm eleleNilavemtats 

Like Raspberry Pi computers, Raspberry Pi gL eT Les ace ual 


: . ; } built-in sensor ona 
Pico features a pin header with 40 cOnmMections, SparkFun SerLCD 
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along with a new debug connection enabling you 
to analyse your programs directly from another 
computer (typically by connecting it directly to the 
GPIO pins on a Raspberry Pi). 


Raspberry Pi Pico 
represents the start of a 
new erd for Raspberry PI 


Pico is an incredibly interesting new device from 
Raspberry Pi. It offers a wealth of connectivity for 
external hardware — and enough processing power 
to handle complex tasks. All this in a compact 
board which costs less than a cup of coffee. You 
can pick up a Pico from just $4 / £3.60, or free on 
the latest edition of HackSpace magazine (see ‘Get 
your free Pico’). 

Built with everyone from absolute beginners to 
professional engineers in mind, Raspberry Pi Pico 
represents the start of a new era for Raspberry Pi. 
We can’t wait to see what you all make with it. 


MagPi 
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GET TO KNOW 


RASPBERRY Pl PICO esses 


Take a tour of Raspberry Pi Pico and the RP2040 chip which drives It 


aspberry Pi Pico is a brand new, low-cost, 
yet highly flexible development board 
designed around a custom-built RP2040 
microcontroller chip designed by Raspberry Pi. 

Raspberry Pi Pico — ‘Pico’ for short — features 
a dual-core Cortex-Mo+ processor (the most 
energy-efficient Arm processor available), 264kB 
of SRAM, 2MB of flash storage, USB 1.1 with 
device and host support, and a wide range of 
flexible [/O options. 

ine ears vellehweral onlin lneveYaleies, Sinls\uh fe earere, 
is equally at home on a breadboard for 
experimentation as it is soldered onto a circuit 
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Specifications 


board and driving a finished product. The high- 
performance processor cores coupled with RAM 
and storage give it impressive flexibility. 

A real highlight comes in the form of 
Programmable Input/Output (PIO) capabilities: 
bridging the gap between software and hardware, 
Pico’s PIO allows developers to define new 
hardware features in software — expanding its 
capabilities beyond any fixed-function device. 

Pico is set to prove itself not just an impressive 
new tool for Raspberry Pi users, but a must- 
have gadget for anyone investigating physical 
computing projects. 


> RP2040 microcontroller chip designed by Raspberry Pi in the 


United Kingdom 


Vv 


to 133MHz 
264kB of SRAM, and 2MB of on-board flash storage 


USB 1.1 Host and Device support 


Low-power sleep and dormant modes 


26 multifunction GPIO pins 


Accurate clock and timer on-chip 


Temperature sensor 


Fast floating-point Libraries in ROM 


> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 


8x Programmable IO (PIO) state machines for custom 
peripheral support 
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Dual-core ARM Cortex-Mo+ processor, flexible clock running up 


Castellated module allows soldering direct to carrier boards 


Drag & drop programming using mass storage over USB 


2x SPI, 2x 12C, 2x UART, 3x 12-bit ADC, 16x controllable PWM channels 


C | BOOTSEL 

Hold the BOOTSEL (boot select) button 
when powering up Pico to put it into 
USB Mass Storage Mode. From here, 


you can drag-and-drop programs, 
created with C or MicroPython, into 


the RPI-RP2 mounted drive. Pico runs 
the program as soon as it is switched 
on (without BOOTSEL held down) 








MagPi 
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RP2040 is a custom-built dual-core 
microcontroller, designed in-house 
at Raspberry Pi 
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ia) 3V3_EN 
— A Serial Wire Debug (SWD) header 


mp vocvecr a ak provides hardware debugging 
> cp2e_a2 AXA @ capabilities, letting you quickly track 
aye 





i cup GHD | down problems in your programs 
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SAY HELLO T0 RP2040 


What Is g microcontroller? Get to know the technology 
inside Raspberry Pi's home-made silicon 


P2040 is a low-cost microcontroller 
R device, with the same focus on quality, 
cost, and simplicity that characterises the 
‘big’ Raspberry Pi. Microcontrollers interact with 
the hardware of a board much like an application 
processor does in a larger device. 

Application processors like the Broadcom BCM2711 
used in Raspberry Pi 4 are designed to run multiple 
programs under an operating system, like Raspberry 
Pi OS. These programs access external hardware 
through interfaces provided by the operating system. 

In contrast, microcontrollers like RP2040 
interact directly with external hardware and 
typically run a single program from the moment 
you turn them on. 

Just as Raspberry Pi is an accessible computer, 
RP2040 is an accessible microcontroller, 
containing almost everything makers need to 
embed it inside a product. 

RP2040 is supported by both C/C++ and 
MicroPython cross-platform development 
environments, including easy access to runtime 
debugging. It has a built-in UF2 bootloader 
enabling programs to be loaded by drag-and-drop. 
The built-in USB can act as both device and host. 
Meanwhile, floating-point routines are baked 
into the chip for ultra-fast performance. It has 
two symmetric processor cores and high internal 





Behind the name 2040 


The post-fix numeral on RP2040 comes from 
the following: 
1. Number of processor cores (2) 


2. Loosely which type of processor (MO+) 

3. The amount of RAM, from the function 
floor(log (RAM / 16kB)), in this case it’s 256kB 

4. The amount of non-volatile storage, from the 
function floor(log (non-volatile 7 16kB)), or 0 if no 
on-board non-volatile storage 
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bandwidth, making it useful for signal processing 
and video applications. The chip has a relatively 
large amount of internal RAM but uses external 
flash storage, allowing you to choose how much 
memory you need. 





«BN, egelee)aidge)i=)esme|d-melam=>. (aq pei ple mal=\\\meln=le 
for Raspberry Pi fans to explore @ 


Microcontrollers are an exciting new area for 
Raspberry Pi fans to explore. See the RP2040 data 
sheet for more information (magpi.cc/2040data). 



















The heart of Raspberry 
Pi Pico, RP2040 is a 
laalroigeyalage)it-lmaisamsve)aalc) 
Viale [etomaelateiile)are lain, 


aMal-wsilelaliirerslalecmelmuals 
R-lanciecmelalemel(e|iecmial 
RP2040's name 


floor(log (non-volatile/16kB)), or 0 if 
no on-board non-volatile storage 


floor(log (RAM/16kB)) 
Loosely which type 
of processor (Mo+) 
Number of cores 
Raspberry Pi 
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PRUGRAMMING 
RASPBERRY PI PICO 


Raspberry Pi Pico is designed for everyone, 


from complete beginners to engineers 


ico is programmed using either C/C++ or 
P MicroPython and there is IDE support for 

Visual Studio Code and Eclipse. Adding a 
program to Pico is as easy as dragging and dropping 
a file while Raspberry Pi Pico is in boot mode. 

MicroPython is an implementation of the Python 
programming language that is already popular 
among Raspberry Pi users. MicroPython is built 
specifically for microcontrollers like the RP2040 
that powers Raspberry Pi Pico. 

MicroPython offers the same friendly syntax as 
Python. It allows for full control over Raspberry Pi 
Pico’s various features, including its Programmable 
iGeholenwA@)ehaoleim@ 1) machelelate)erclbiars 

Programs written for other MicroPython- 
compatible microcontroller boards will work on 
Raspberry Pi Pico, and vice versa — sometimes 
needing minor modification for different features 
between boards — giving Raspberry Pi Picoa 





7 Wa Nal ltoixolesvaiarelam elceye]gelan 
that blinks Raspberry Pi 
Pico'’s LED on and off 


healthy library of projects and tutorials beyond 
those developed by Raspberry Pi itself. 
Meanwhile, the C/C++ SDK is fine-tuned to 
RP2040 and has all the headers, libraries, and build 
systems necessary to write programs in C, C++, 
or assembly language. Additionally, the C/C++ 
SDK provides higher-level libraries for dealing 
with timers, USB, synchronisation, and multicore 
programming, along with additional high-level 
functionality built using PIO such as audio. 
Beginners looking to get started with the 
MicroPython port should start with the Raspberry 
Pi Pico Python SDK documentation and be sure to 
pick up a copy of Getting Started with MicroPython 
on Raspberry Pi Pico and read the tutorial on the 
following pages. 
Makers looking to explore the C/C++ SDK should 
download the Pico C/C++ SDK documentation 
Gant. 1:40) aeypo) (eorenyel Op 


Raspberry P1 
data sheets 


Make sure to read, and bookmark, 
these new Raspberry Pi Pico and 
2040 data sheets. 


Pico Python SDE 
A MicroPython environment 
for the RP2040 microcontroller 


Pico Python SDK 


magpi.cc/picopythonsdk 


Pico C/C++ SDK 
magpi.cc/picocsdk 


Raspberry Pi Pico data sheet 
magpi.cc/picodatasheet 


RP2040 data sheet 
magpi.cc/2040datasheet 
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JAMES ADAMS AND 
NICK FRANCIS ON 


RASPBERRY PI PICU 


What goes into making Raspberry Pl's first in-house 












t’s a flexible product and platform,” says 





anliagelee)ajane)i(=lqne|aremel=\\/=1[e)e]ae|-injenelelelse 
be Nick Francis, Senior Engineering Manager 
at Raspberry Pi, when discussing the 

work the Application-Specific Integrated Circuit 
(ASIC) team put into designing RP2040, the 
microcontroller at the heart of Raspberry Pi Pico. 

It would have been easy to have said well, let’s 
do a purely educational microcontroller “quite 
low-level, quite limited performance,” he tells 
us. “But we’ve done the high-performance thing 
without forgetting about making it easy to use 
for beginners. To do that at this price point is 
really good.” 

“T think we’ve done a pretty good job,” 
agrees James Adams, Chief Operating 
Officer at Raspberry Pi. “We’ve 
obviously tossed around a lot of 


different ideas about what we 
could include along the way, 


alelaa=sw-\elelagss 


James Adams, Chief 
Operating Officer at 
Raspberry Pi 





Nick Francis 


Nick Francis, Senior 
stave ]iat=x-)alalemialclalc\e|=16 
at Raspberry Pi 


Understanding PIO 


Programmable Input/Output (PIO) is a key feature of RP2040 and something 
we're very excited about. “The Programmable IO block is one of the main highlights,” 
says Nick. “It's a very flexible multi-configuration, multi-state-machine I/O controller. 
Essentially, we can interface to anything you can think of - within sensible limits.” 

“Maybe the way to describe it is: it's a custom processor, a core designed for bit- 
banging input/output [|/O],” James adds. “It’s got instructions and memory, but it's 
highly specialised to do I/O bit-banging. It has FIFOs - first in, first out hardware memory 
buffers — to stuff data in, shuffle data in and out, and stuff like that. It's pretty cool.” 

“It gets whoever's going to use the device closer to their hardware,” says Nick. “So 
you get to really, really think about the bits and how you're talking to the external 
devices. The list of interfaces it will support will grow over time, and it should be a bit of 
interesting fun for people to try and hook them up and make it support different things.” 
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and we’ve iterated quite a lot and got down toa 
eood set of features.” 


pW sleleldeMelaemaalie 

“The idea is it’s [Pico] a component in itself,” says 

James. “The intent was to expose as many of the 
I/O (input/output) pins for users as possible, and 
expose them in the DIP-like (Dual Inline Package) 
form factor, so you can use Raspberry Pi Pico as 
you might use an old 40-pin DIP chip. Now, Pico 

is 2.54 millimetres or 0.1 inch pitch wider than a 
‘standard’ 40-pin DIP, so not exactly the same, but 
still very similar. 













“After the first prototype, I changed the pins to 
be castellated so you can solder it down as a module, 
without needing to put any headers in. Which is, 
yes, another nod to using it as a component.” 


Getting the price right 
“One of the things that we’re very excited about is 
the price,” says James. “We’re able to make these 
available cheap as chips — for less than the price of 
a cup of coffee.” 

“It’s extremely low-cost,” Nick agrees. “One 
of the driving requirements right at the start 
was to build a very low-cost chip, but which also 
had good performance. Typically, you’d expect a 
microcontroller with this specification to be more 
expensive, or one at this price to have a lower 
specification. We tried to push the performance 
and keep the cost down.” 


M@ We're able to make these 
available cheap as chips @ 


Raspberry Pi Pico also fits nicely into the 
Raspberry Pi ecosystem: “Most people are doing 
a lot of the software development for this, the 
SDK (software development kit) and all the rest of 
it, on Raspberry Pi 4 or Raspberry Pi 400,” James 
explains. “That’s our primary platform of choice. 
Of course, we’ll make it work on everything else as 
well. I would hope that will be as easy to use as any 
other microcontroller platform out there.” 






























A Areel of Raspberry Pi Pico 
laalieigexerolalace)ikq1m elel-Ine() 
ready for distribution 
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WITH MICROPY THON 





Take your first steps with Raspberry Pi Pico and learn to program 
your new microcontroller. By Gareth Halfacree 





> Raspberry Pi 
computer 
magpi.cc/products 


> Raspberry Pi Pico 
magpi.cc/pico 


> MicroPython SDK 
magpi.cc/ 
picopythonsdk 


> Internet connection 


with the C/C++ Software Development Kit 
(SDK). The C/C++ SDK is an extremely flexible 
and powerful way to interact with your Raspberry 
Pi Pico. However, there’s a more beginner-friendly 
method: MicroPython, a port of the Python 
programming language designed specifically 
for microcontrollers. 

In this tutorial we’re going to switch the Pico 
firmware from C/C++ to MicroPython and create our 
first program, which flashes the LED on the board. 

In the next tutorial we will demonstrate how to 
attach pins and wire up your Pico so it’s ready for 
you to explore a wealth of electronic projects. 


R aspberry Pi Pico is set up, by default, for use 


Open in boot mode 
Take your Raspberry Pi Pico and a micro USB 
to USB-A cable, and connect the small micro USB 


BD © By Th there, . -uretes. _ Th Weert even? 


ss Ky 


head 


4 © 


[teeta veel py] SC | curtis * 
| dapert machine 
> import wt Lime 
Led onboard = machine Pin(25, machioe. Pin. OUT) 
ai 


( while Tre 


Led onboard. toggle} 
1} 


b utine. sleepi 


Shell 


Helle World 


i 


MicroPython SDK in Thonny is 
Ult=Yo Kom ab lam o)ceye|e-laaiomel|a-reisnvme) a 
the connected Raspberry Pi Pico 
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end of Pico. Hold down the small button on your 
Raspberry Pi Pico marked ‘BOOTSEL’ and plug the 
larger USB-A cable end into your computer (we are 
using a Raspberry Pi). 

Wait a few seconds, then let go of the BOOTSEL 
button. You will see your computer mount a 
removable drive. Click OK in the ‘Removable 
medium is inserted’ window to open Raspberry Pi 
Pico’s on-board storage. 


Flash the MicroPython firmware 

Double-click the INDEX.HTM file displayed 
in Pico’s mounted storage. Your browser will open 
and display the ‘Welcome to your Raspberry Pi 
Pico’ webpage. Choose the ‘Getting started with 
MicroPython’ tab, and click ‘Download UF2 file’ to 


Ve] $ Tl ©) 2a 


Switch to the MicroPython 
(Raspberry Pi Pico) interpreter 
with this option in the bottom- 
fate lalmexe)dal=) area Malevalayy, 





SD WB btey-are 


download the MicroPython firmware. It’s a small 
file, so it’ll only take a few seconds. 

Open File Manager and locate the micropython- 
16-DEC-2020.uf2 file in the Downloads folder 
(the file name may have been updated with a later 
date). Drag-and-drop the UF2 file to the Raspberry 
Pi Pico’s removable drive (named ‘RPI-RP2’). After 
a few seconds, the drive will disappear as the new 
MicroPython firmware is recognised and installed. 


Switching the back end 

The best way to program in MicroPython on 
your Raspberry Pi Pico is with the Thonny Python 
IDE (integrated development environment). Open 
the Raspberry Pi menu and choose Programming > 
Thonny Python IDE. 

Thonny is normally used to write programs that 
run on the same computer you’ re using Thonny on; 
to switch to writing programs on your Raspberry 
Pi Pico, you’ll need to choose a new Python 
interpreter. Look at the bottom-right of the Thonny 
window for the word ‘Python’ followed by a version 
number: that’s your current interpreter. 

Click ‘Python’ and look through the list that 
appears for ‘MicroPython (Raspberry Pi Pico)’ — 
or, if you’re running an older version of Thonny, 
‘MicroPython (generic)’. 


vwetie 





Hello World! 


Writing a program for your Raspberry Pi Pico 
is a lot like writing a program for your Raspberry 
Pi. You can type commands in the Shell area at the 
bottom of the window to have them immediately 
executed, or you can write a program in the main 
part of the window to run on-demand. 

Click in the Shell area, next to the >>>> symbols, 
and type: 





print("Hello, World!") 





blinky_led.py 





> Language: MicroPython 


utime.sleep(1) 


When you press ENTER at the end of the line, 
you’ ll see your Raspberry Pi Pico respond. Try typing 
the same line again, but in the main part of the 
Thonny window — then click the Run icon. You’l] 
be asked whether you want to save your program 
to ‘This computer’ or ‘Raspberry Pi Pico’. Click on 
‘Raspberry Pi Pico’, give your program the name 
hello_world.py, then click OK to save and run your 
first program. 


Blinky LED 


While Raspberry Pi Pico can run Python 
programs like the one above, its true power comes 
from interfacing with external hardware like 
buttons and LEDs. You can start programming 

a physical computing project without any extra 
hardware, too, thanks to an on-board LED 
(assigned to the non-broken-out GP25 pin). 

Click the New icon and type in the blinky_led.py 
code. Click Run, save the program to your Raspberry 
Pi Pico, and watch the LED on Raspberry Pi Pico: it 
will turn on for one second, then off for one second, 
then repeat. 
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Q01. import machine 

Q02. import utime 

Q03. led onboard = machine.Pin(25, machine.Pin.OUT) 
Q04. while True: 

05. led_onboard.toggle() 


Update Thonny 


If you don't see 
MicroPython 
(Raspberry Pi Pico) 
in the interpreter 
list, you'll need to 
update Thonny. 
Open a Terminal 
window and type: 


sudo apt update 
&& sudo apt 
full-upgrade -y 


Switch the interpreter 
to MicroPython 
(Raspberry Pi Pico) 

in Thonny using the 
drop-down menu 


RASPRARY Fl Poo 
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SULDER HEADERS 
TO RASPBERRY PI PICO 


Attach headers to Raspberry Pi Pico and get ready 
to explore electronics, by Gareth Halfacree 





hen you unpack Raspberry Pi Pico, attach pin headers. You’1!] need a soldering iron 
W you’ll notice that it is completely flat: with a stand, some solder, a cleaning sponge, 
there are no metal pins sticking out Raspberry Pi Pico, and two 20-pin 2.54mm male 
from the sides, like you’d find on the GPIO header header strips. If you already have a solderless 
of Raspberry Pi. This is in case you wanted to use breadboard, you can use it to make the soldering 
: the castellations (bumpy edges) to attach Pico to process easier. 
Warning! naa . 
Hot solder! another circuit board, or to directly solder wires. Sometimes 2.54mm headers are provided in 
| The easiest way to use Pico, though, is to attach strips longer than 20 pins. If yours are longer, 
Soldering irons get very it to a breadboard — and for that, you’1l need to just count 20 pins in from one end and look at 


hot, and stay hot for a 
long time after they're 
unplugged. Make 
sure that you put the 
iron in the stand when 
you're not using it and 
don't touch the metal 
parts - even after it’s 
unplugged. 
magpi.cc/soldering 


ie ® 


Make sure the longer pins 
roJali dal=mat=xale(-lar-le-mirclellale 
downwards, away from 
the chips on the surface of 


Raspberry Pi Pico (so they 
fore) al a\syeoi mi Kom Nal=Me)a=vale| eley=lce)) 


Biat=iom o)lalsmare\ce 
been well-soldered 
to Raspberry Pi Pico 





You'll Need 


> Raspberry Pi Pico 
magpi.cc/pico 


> 2 x 20-pin headers 
magpi.cc/headers 


> Soldering tron 
and solder 
magpi.cc/ 
solderingiron 
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the plastic between the 20th and 21st pins: you’ ll 
see it has a small indentation at either side. 
This is a break point: put your thumbnails in the 
indentation with the headers in both your left and 
right hands and bend the strip. It will break cleanly, 
leaving you with a strip of exactly 20 pins. If the 
remaining header strip is longer than 20 pins, do 
the same again so you have two 20-pin strips. 
Turn Raspberry Pi Pico upside-down, so you can 
see the silkscreen pin numbers and test points 
on the bottom. Take one of the two header strips 
and push it gently into the pin holes on the left- 


M Take one of the two header 
Strips and push it gently 
Into the pin holes @ 


hand side of your Pico. Make sure that it’s properly 
inserted in the holes, and not just resting in the 
castellations, and that all 20 pins are in place, then 
take the other header and insert it into the right- 
hand side. When you’ve finished, the plastic blocks 
on the pins should be pushed up against your 
Pico’s circuit board. 

Pinch your Pico at the sides to hold both the 
circuit board and the two pin headers. Don’t let 
go, or the headers will fall out! If you don’t have 
a breadboard yet, you’ 11 need some way to hold 


the headers in place while you’re soldering — and 
don’t use your fingers, or you’ll burn them. You 
can hold the headers in place with small alligator 
clips, or a small blob of Blu Tack or other sticky 
putty (Figure 1). Solder one pin, then check 

the alignment: if the pins are at an angle, melt 
the solder as you carefully adjust them to get 
everything lined up. 


Use a breadboard 

If you have a breadboard, simply turn Raspberry 
Pi Pico upside down — remembering to keep the 
headers pinched — and push both the headers 





WV Figure 2 Alternatively, use a breadboard to hold the headers 


in place for soldering 
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<q Figure 1 You can hold 


the headers in place 
with sticky putty 
before soldering 


Take it slow 


Soldering is a 
great skill to learn, 
but it does take 
practice. Read the 
directions that 
follow carefully 
and in full before 
even turning your 
soldering iron on, 
and remember to 
take things slowly 
and carefully. 
Avoid using too 
much solder, too: 
it's easy to add 
more to a joint 
with too little 
solder, but can 

be harder to take 
excess solder 
away — especially 
if it's solashed 
over to other parts 
of your Pico. 
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Four corners 
first 





Solder the four 
corner pins first. 
Take your time, 
don't rush, and 
remember that 
mistakes can 
always be fixed. 


and your Pico into the holes on the breadboard. 
Keep pushing until your Pico is lying flat, with 

the plastic blocks on the pin headers sandwiched 
between your Pico and your breadboard (Figure 2). 

Look at the top of your Pico: you’ ll see a small 
length of each pin is sticking up out of the pin 
holes. This is the part you’re going to solder — 
which means heating up both the pins and the 
pads on Pico and melting a small amount of a 
special metal, solder, onto them. 

Put your soldering iron in its stand, making sure 
the metal tip isn’t resting up against anything, and 
plug it in. It will take a few minutes for the tip of 
the iron to get hot; while you’re waiting, unrolla 
small length of solder — about twice as long as your 
index finger. You should be able to break the solder 
by pulling and twisting it; it’s a very soft metal. 

If your soldering stand has a cleaning sponge, 
take the sponge to the sink and put a little bit of 
cold water on it so it softens. Squeeze the excess 
water out of the sponge, so it’s damp but not 
dripping, and put it back on the stand. If you’re 
using a cleaner made of coiled brass wire, you don’t 
need any water. 


How to solder correctly 






A Figure 3 Heat the pin and pad 


A Figure 5 Now remove the iron 
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Figure 4 


Start to solder 

Pick up your soldering iron by the handle, making 
sure to keep the cable from catching on anything 
as you move it around. Hold it like a pencil, 

but make sure your fingers only ever touch the 
plastic or rubber handle area: the metal parts, 
even the shaft ahead of the actual iron tip, will be 
extremely hot and can burn you very quickly. 


M Putting a blob of solder on 
the tip is known as tinning 
the tron @ 


Before you begin soldering, clean the iron’s tip: 
brush it along your sponge or coiled wire cleaner. 
Take your length of solder, holding it at one end, 
and push the other end onto the tip of your iron: it 
should quickly melt into a blob. If it doesn’t, leave 
your soldering iron to heat up for longer — or try 
giving the tip another clean. 

Putting a blob of solder on the tip is known as 
tinning the iron. The flux in the solder helps to 





A Figure 4 Add alittle solder 





A Figure 6 A well-soldered pin 


burn off any dirt still on the end of the iron, and 
gets it ready. Wipe the iron on your sponge or 
cleaning wire again to clean off the excess solder; 
the tip should be left looking shiny and clean. 

Put the iron back in the stand, where it should 
always be unless you’re actively using it, and 
move your Pico so it’s in front of you. Pick up 
the iron in one hand and the solder in the other. 
Press the tip of the iron against the pin closest to 
you, so that it’s touching both the vertical metal 
pin and the gold-coloured pad on your Pico at the 
same time (Figure 3). 

It’s important that the pin and the pad are both 
heated up, so Keep your iron pressed against both 
while you count to three. When you’ve reached 
three, still keeping the iron in place, press the end 
of your length of solder gently against both the 
pin and pad but on the opposite side to your iron 
tip (Figure 4). Just like when you tinned the tip, 
the solder should melt quickly and begin to flow. 

The solder will flow around the pin and the pad, 
but no further: that’s because Pico’s circuit board 
is coated in a layer called solder resist which Keeps 
the solder where it needs to be. Make sure not to 
use too much solder: a little goes a long way. 


Remove solder first 

Pull the remaining part of your solder away from 
the joint, making sure to keep the iron in place. If 
you pull the iron away first, the solder will harden 
and you won’t be able to remove the piece in your 
hand; if that happens, just put the iron back in 
place to melt it again. Once the molten solder 

has spread around the pin and pad (Figure 5), 
which should only take a second or so, remove the 
soldering iron. Congratulations: you’ve soldered 
your first pin! 

Clean the tip of your iron on your sponge or 
brass wire, and put it back in the stand. Pick up 
your Pico and look at your solder joint: it should 
fill the pad and rise up to meet the pin smoothly, 
looking a little like a volcano shape with the pin 
filling in the hole where the lava would be, as 
shown in Figure 6. 

Once you’re happy with the first pin, repeat the 
process for all 40 pins on your Pico — leaving the 
three-pin ‘DEBUG’ header at the bottom empty. 
Remember to clean your iron’s tip regularly 
during your soldering, too, and if you find things 
are getting difficult, melt some solder on it to 
re-tin the tip. Make sure to keep refreshing your 
length of solder, too: if it’s too short and your 
fingers are too close to the soldering iron’s tip, 
you can easily burn yourself. 
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When you’re finished, and you’ve checked all 
the pins for good solder joints and to make sure 
they’re not bridged to any nearby pins, clean and 
tin the iron’s tip one last time before putting it 
back in the stand and unplugging it. Make sure to 
let the iron cool before you put it away: soldering 
irons can stay hot enough to burn you for a long 
time after they’ve been unplugged! 

Finally, make sure to wash your hands — and 
celebrate your new skill as a soldering supremo! H 


Soldering issues 


If the solder is sticking to the pin but not sticking to the copper pad, as in example A 
in Figure 7, then the pad wasn't heated up enough. Don't worry, it’s easily fixed: take 
your soldering iron and place it where the pad and pin meet, making sure that it's 
pressing against both this time. After a few seconds, the solder should reflow and 
make a good joint. 

On the other hand, if the solder is too hot, it won't flow well and you'll get an 
overheated joint with some burnt flux (example B). This can be removed with a bit of 
careful scraping with the tip of a knife, or a toothbrush and a little isopropyl alcohol. 

If the solder is entirely covering the pin, as in example C, you used too much. 
That's not necessarily going to cause a problem, though it doesn't look very 
attractive: so long as none of the solder is touching any of the pins around tt, it 
should still work. If it is touching other pins (as in example D), you've created a bridge 
which will cause a short circuit. 

Again, bridges are easy to fix. First, try reflowing the solder on the joint you were 
making; if that doesn't work, put your iron against the pin and pad at the other side 
of the bridge to flow some of It into the joint there. If there's far too much solder 
still. you'll need to remove the excess before you can use your Pico: you can buy 
desoldering braid, which you press against the molten solder to suck the excess up, 
or a desoldering pump to physically suck the molten solder up. 

Another common mistake Is too little solder: if you can still see copper pad, or 
there's a gap between the pin and the pad which isn't filled in with solder, you used 
too little (example E). Put the iron back on the pin and pad, count to three, and add 
a little more solder. Too little is always easier to fix than too much, so remember to 
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MicroPython 
on Raspberry P1 P1CO 
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Get started with 


MicroPython 


on Raspberry P1 Pico 


Learn how to use your new Raspberry Pi Pico 
microcontroller board and program it using 
MicroPython. Connect hardware to make your 
Pico interact with the world around it. Create 
your own electro-mechanical projects, whether 
for fun or to make your life easier. 


Oe aIOrNE 


RASPBERRY PI 


PICO GUIDE 





® Set up your Raspberry PiPico © Control and sense 


and start using it electronic components 
® Start writing programs ® Discover how to use Pico’s 
using MicroPython unique Programmable IO 


Available now: magpl.cc/picobook 
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nky Impression 


> Pimoroni » magpi.cc/impression » £66/$75 





DISPLAY: 
5.7-inch EPD, 
600x448 pixels, 
ACeP seven- 
colour, >170° 
viewing angle 


FEATURES: 

4 x tactile 
buttons, 
breakout header 
including 

I2C, SPI, 3V3, 

5V, ground 


DIMENSIONS: 
125.4 x 99.5 x 
9mm 


USABLE 
DISPLAY 


AREA: 
114.9x85.8 mm 


inch e-ink screen 
can display 
full-colour images 


Create your own portable art gallery with this extra-large 
e-ink display featuring full colour, By Phil King 


he Inky Impression is a super-size e-ink 

display that gives a great first impression 

as soon as you take it out of the box. Ours 
came with a beautiful impressionist painting by 
Lilla Cabot Perry as the default image. 

Its 5.7-inch display is much bigger than 
Pimoroni’s previous e-ink boards, the Inky wHAT 
and pHAT. Indeed, it’s considerably larger than 
a full-size Raspberry Pi board, for which an extra 
female header (to boost its height) and metal 
standoffs are supplied. Care is needed to hold it 
by the edges when mounting, so as not to push 
down on the glass panel. Alternatively, it fits 
flush on a Raspberry Pi Zero without the extra 
header, for a reduced overall depth — great for 
putting it in a wooden frame for wall mounting. 
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If using a Raspberry Pi 400, you’ ll need a GPIO 
extender cable. 

The slimline board even features some breakout 
GPIO pins on the underside, including I2C and SPI, 
along with four tactile buttons on its left edge - 
these could be handy for switching between images 
or sets of them in a headless picture frame setup. 


Now in full colour 

In addition to its size, the other major plus point 
about the Inky Impression is that it now uses ACeP 
(Advanced Color ePaper) to deliver seven colours: 
black, white, red, green, blue, yellow, and orange. 
This means it can display standard RGB images 
without the hassle of having to alter the colour 
mode to a special indexed palette in an image 
editor, as is required on the Inky WHAT and pHAT. 
So it’s far easier to download or transfer images 
to use Straight away; they just need to be 600x448 
pixels, so may need scaling and/or cropping. Most 
major file formats are supported. 


M |t can display standard RGB 
Images without having to 
alter the colour mode @ 


We found that simpler images, without too much 
detail, tended to work best. In particular, the Inky 
Impression is ideal for showing pop art, comic- 
book panels, and pixel art. Most standard photos 
will look fine on it, although you may find that the 
colours are a little washed out compared to the 
original image — this can be alleviated somewhat 
by altering the contrast and colour saturation of 
the photo. 
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As with all e-ink displays, it takes a few seconds 


to change to a new image (so it’s no use for 
animations or videos), with a fair bit of flashing 
as it refreshes the different colour layers. There is 
also the possibility of some ‘ghosting’ as strong 


elements from the previous image may sometimes 
be noticeable — the best way to solve this is to show 


an all-white image between them. 


Code examples 

To use the Inky Impression, you’ ll need to 
download the Inky Python library (as used by 
previous boards), either using a one-line installer 
or cloning/downloading the GitHub repo 
(magpi.cc/inkygit) — the latter may be more up 
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to date. This includes a ‘7color’ folder of Inky 
Impression code examples to get you started and 
demonstrate some of its use-cases. 

Along with code to display a selected image, 


there’s a nice example for a simple HTML webpage, 


which offers a convenient way of showing styled 
text on the screen. There’s also a neat graphing 
example that plots coloured circles for data, 
illustrating how the Inky Impression could be 
useful for showing sensor or weather data in 
colourful charts. If using battery/portable power, 
a big advantage over a conventional display is the 
extremely low energy drain: it only draws power 
when changing images, which otherwise stay on 
screen even with the power disconnected. 


: 


600x448 pixels 
es eo | 5.7" e-paper display 
125x100mm overall 

115x86mm active 


MagPi 





A Raspberry Pi Zero 
fits neatly on the rear, 
or the HAT can be 
mounted on a full- 
size model with the 
extra female header 
and standoffs 





A size comparison with 
the Inky pHAT and 
WHAT boards; the Inky 
Impression (rear) is 
considerably larger 


Verdict 


While its lengthy 
screen refresh 
time means it's 
not suitable for 
every project, 
it's ideal for use 
as a digital art/ 
picture frame 
or for displaying 
data in 
graphical form. 


S, 10 
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RFID HAT 





OPERATING 
SPECS: 

Voltage: 5V; 
frequency: 
125kHz; interface: 
UART; baud rate: 
9600 bps 


1/0: 

40-pin GPIO 
header, 0.91-inch 
OLED display, 
buzzer, card 
indication LED, 
power LED 


DIMENSIONS: 
55x66mm, 
Ri5mm 
mounting holes 





Verdict 


A fantastic HAT 
with good-quality 
components, 
and the OLED 
display is a 

nice touch. The 
documentation 
could be better, 
but we found 
everything easy 
to set up and 
understand. 
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> SB Components >» magpi.cc/rfidhat >» £25 /S34 


Add tap-and-track technology to your projects with this RFID reader, 


By Lucy Hattersley 


FID (radio frequency identification) 
a technology has slowly surrounded us 

in the last few years. Tapping to pay for 
things, to open doors, take and return books from 
the library, and to access equipment has become 
the norm. Many things we do now involve a tap of 
some sort. 

The RFID HAT from SB Components comes 
with an RFID Module reader and two RFID tags (a 
plastic card and a key fob). On the HAT is also a 
small 0.91-inch OLED display, buzzer, and LEDs 
for power and card detection. There is also a GPIO 
extension header, enabling you to hook up the 
RFID HAT components to further items. 


M™ We've seen many Raspberry 
P| projects make great use 
of RFID technology 


The HAT (Hardware Attached on Top) runs 
a UART (Universal Asynchronous Receiver/ 
Transmitter) in the 125GHz frequency range. You 
can pick up extra RFID tags, cards, and stickers for 
very little cost. Each RFID tag contains a unique 
identification number, which is detected when 
the tag is placed next to the RFID reader on 
the HAT. 


RFID projects 

We’ve seen many Raspberry Pi projects 
make great use of RFID technology. 
Perhaps the most famous is Museum 

in a Box (magpi.cc/miab). This project 
enables people to pick up objects and tap 
them to a Raspberry Pi-controlled speaker 
and hear an audio response. We’ve also seen 
a few projects that play Spotify albums when a 
model of the physical media is brought next to 


the RFID reader. In addition, you can use RFID for 
more standard projects such as ID badging, access 
control, and tracking of items. 

Thanks to HAT technology, the installation 
is taken care of with the built-in EEPROM. 

You need to activate I2C and Serial Interface in 
Raspberry Pi OS, but it took all of five minutes to 
eet everything up and running. There are some 
instructions in the store page, but we found it 
clearer to follow the instructions on the GitHub 
page (magpi.cc/sbrfidgit). 

Once set up, there are three sample scripts: one 
which displays the RFID ID on the command line, 
one which displays it on the OLED screen and rings 
the buzzer, and a third that displays the LED on the 
board when an RFID tag is detected. 

We couldn’t find API documentation, but reading 
the sample scripts was easy enough. Still, we would 
prefer to see more detail in the documentation. 

We had fun playing around with the RFID HAT, 
and think it’d be a great way to implement RFID 
technology into your Raspberry Pi project. Hl 


V_ SB Components’ RFID HAT connects neatly 
on top of a Raspberry Pi Model B 





NanoSound ONE 





H1-F1 DAC Case 


> Nanomesher » magpi.cc/nanosound1 P» £59 / S80 


Combine the best of both worlds with ag melding of the excellent NanoSound 
DACs and the Argon ONE case. Rob Zwetsloot grabs his listenin’ ears 


Argon ONE cases -— they’re fantastic for 
keeping your Raspberry Pi cool, they look 
great, and they have neat features like GPIO pins 
under a magnetic lid and all the ports rearranged 

to the rear. We’re also a fan of the NanoSound 
DACs, so we were quite intrigued when we found 
out about a melding of the two into one product: 
NanoSound ONE. 


t’s no secret that we’re big fans of the 


M You have your choice of 
bottom part for the case 


On paper it’s a simple change — the board 
attached to the roof of the case that provides a fan 
and heatsink is replaced with one that provides 
a DAC and heatsink. Because of this, the ports 
on the rear are slightly changed, going from two 
HDMI ports and a 3.5mm jack to one micro HDMI 
port and two RCA jacks. 

This does mean you’ re losing the active cooling. 
However, passive cooling of the heatsink (which is 
the entire case) is definitely good enough. 


Snug fit 

Installing a Raspberry Pi 4 is simple — you add the 
little breakout board that plugs into HDMI 0 and 
the 3.5mm jack on Raspberry Pi, and then connect 
the GPIO pins with the GPIO header on the top of 
the case. The breakout board is a bit of a snug fit, 
so don’t be worried if it looks like it’s not quite 
spaced out correctly. It is! 


You have your choice of bottom part for the case. 


The standard piece just encloses the whole thing 
and provides an SD card port, while there’s also 
the M.2 SSD storage bay option which we reviewed 
last month. 


The whole process is very quick, and we were 
able to experience some excellent sounds from the 
DAC part in no time, which uses the same tech as 
the NanoSound DAC 2. You’re paying a little bit 
of a premium for the DAC and case together (only 
about $5), but you are getting a custom version 
of one of our favourite cases — so it’s definitely 
worth it. Hl 
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CHIP: 
Texas 
Instruments 
PCM5122 


SAMPLE 


RATE: 
192 kHz 


RESOLUTION: 
24-bit 


SIGNAL-TO- 


NOISE RATIO: 
112 dB 


AUDIO 


OUTPUT: 
RCA 


4 Controlit witha 


smartphone remote or 
the included remote 





Verdict 


A great case with 
great sound ata 
reasonable price. 
This could be 
the one for folks 
who need the 
best audio out of 
a media centre. 


9, 10 
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Grow Kit 


> Pimoroni » magpi.cc/growkit » From £30 / $34 








aaa If your gardening efforts need a helping hand, Pimoront's got 
Aeon gq HAT-based kit for that. Rosie Hattersley samples some herbs 
INPUT/ 

OUTPUT: s the days begin to lengthen, it’s a 

Four tactile , F 

biittons,pieze A great time to start planting seeds and 

buzzer, LTR- encouraging new green shoots. Cold nights 

559 light and and heating can play havoc with the germination 

proximity sensor process, foxing both plant and gardener, soa 

CONNECTORS: sensor to help keep track of soil moisture can be a 

3 x JST SH 3P real boon. The Grow HAT Mini in this kit provides a 

connectors straightforward means of monitoring the moisture 

for sensors, levels of up to three plants at once. It can either be 

Saati used with your existing plants, in which case you 

eonnectors will only need the standard £30 Grow Kit, which 

with MOSFETs, includes three moisture sensor sticks and cables. 

breakout header Alternatively, there are herb and chilli- growing F you add toe much 






water, the indicator 
turns bright blue 


kits, costing an additional £9.90 ($10.30) each. 


V_Analarm goes off if the 
soil in one of the pots 
becomes too dry 
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wht 


We tested the Grow Herbs kit, reasoning that the 
selection of basil, rosemary, and coriander would 
require quite diverse growing conditions and need 
different watering routines. 

The Grow HAT Mini is sized for use with 
Raspberry Pi Zero, but works with any model with 
a 40-pin GPIO header. Setup involves updating 
Raspberry Pi OS (as with any software install) and 
entering the install code (pimoroni.com/seeds) 
into a Terminal, then rebooting. Once set up, the 
whole caboodle can be run headless (without a 
monitor) from a USB power supply. 


MA sensor to help keep 
track of soll moisture can 
be ad real boon 


If you’ve got the herb or chilli kit, you need 
to soak the Cocopress ‘soil’ pellets in water to 
rehydrate them before planting the seeds. Label 
the three seed sensor sticks and gently attach them 
to the respective plugs on the HAT - rather fiddly 
as the plugs are tiny — and then insert them into 





the soil. A tiny (0.96-inch, 160*80 pixels) IPS LCD 
screen on the HAT immediately indicates whether 
each pot’s soil is wet enough. Blue means too wet, 
while yellow or amber indicates it’s too dry. 


Soily something wrong 

Should the saturation level of any of the plants 
being monitored fall below the threshold, the 
Grow sensor issues a sonic alert — three short 
beeps at roughly three-second intervals - anda 
blue bell icon appears on the Grow HAT’s display. 
To deactivate the alarm, just press the cream- 
coloured button adjacent to the bell. If you don’t 
water the plant within a few minutes, the alarm 
will sound again. 

If the plant in question thrives in a dry 
environment or, conversely, prefers to be pretty 
damp, you can adjust the saturation level at which 
the Grow HAT triggers a warning. Pressing the A 
button on the HAT cycles through the percentage 
moisture level of each pot, and also takes you 
to a Settings menu where you can fine-tune 
the saturation levels for each plant so the alert 
doesn’t constantly trigger for your desert-loving 
aloe vera. 
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<The moisture sensors 


have space to label 
each plant 





Verdict 


We were very 
impressed with 
the kit's ease of 
use, aided bya 
foolproof online 
installation 
guide. There 
were far too 
many seeds for 
the size of the 
pots that came 
with the herb 
and chilli kits, 
but that simply 
means you can 
plant successive 
sets of seeds. 


S, 10 
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4 Raspberry Pi Bus Schedule 


Be on time 


Missing the bus can be a royal pain. Creating your own little info screen with 


| 
10 Amazing: 
a 
the bus schedule for your local stop is a great way to make sure you don't 


unnecessarily leg it out the door in the morning. 
ad ~ () a magpi.cc/bussched 
> LED Light 


q AV | ] fe Sunrise Clock 


Don't be SAD 


| 
Waking with the sun has some 
science behind it that experts say 
means you wake up better. Or 


something. Test out the theory on 
yourself with this cool project. 


Make life a bit easier with these 
Raspberry Pi projects 


magpi.cc/sunriseclock 





aspberry Pi has long _ Pi H ue 


been popular in the 
home automation 
community. With years and 





Automated lights 





Alert! Controlling your lights is a classic home 
years of ideas, projects, and High voltage automation task, and this project allows 
advancements, a lot has been you to control one of the mass-produced 
discovered and created for Some of these smart light bulb standards using a 

. projects use mains 
Raspberry Pi. Here are some Sect Pollo ict) Raspberry Pi. 
of the projects that we think regulations if you plan to : : 
banal aa ace replicate them. magpi.cc/pihue 
might help make life just that pauplee/ 
little bit better. H electricalsafety 









4 LunzPI 4 Touchscreen thermostat 


Radio alarm clock 


: . Automated heating 
This retro-looking alarm clock is anything but - it uses a Spotify 


playlist and can control some light bulbs as well. Make sure Sonny Automatically adjusting the heating in your home using smart devices and very 
& Cher are on the playlist, though. precise rules can be easily achieved using a bit of a hack with a Raspberry Pi. 
magpi.cc/lunzpi magpi.cc/thermostat 
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4 DAKboard 





Info screen 4 Smart coffee machine 


Don't quite want something as large as a magic mirror, but love the idea of a 
smart info board in your home? Try out the DAKboard idea - you can even make 


it look like a picture or small window. Morning brown dispenser 


There's a ritual to making (fancy) coffee that some folks love. Other 
people just need a hit of caffeine in the morning to get themselves 
going. This makes it easier and quicker to get a nice cup of coffee 
to help wake up. 


magpi.cc/dakboard 


magpi.cc/smartcoffee 


v RadioGlobe 


International radio locator 


One of our favourite projects from 2020, this toy globe has been 
heavily modified so that a Raspberry Pi knows where a reticule 
is pointing anywhere in the world and will play radio from that 
location. It's very cool. 


magpi.cc/radioglobe 





4 BOSEBerry Pi 


Internet radio circa 2011 


We recently featured this upcycling build in the magazine, where David Hunt 
took a decade old iPod dock, gutted it, and installed a Raspberry Pi in there for 
a cleaner-looking, customisable, internet radio. 


magpi.cc/boseberrypi 


<«MagicMirror 


Fair and informed 


Make sure you look good and know 
what's up today with this excellent AR 
project that is almost a rite of passage 
for many Raspberry Pi makers. 


magicmirror.builders 





10 Amazing: Day-to-day life projects | magpi.cc | 83 





SE agri | RESOURCES 


Learn MicroPython 
with Raspberry P1 


Get the most from Raspberry Pi Pico by getting to grips with MicroPython, By Lucy Hattersley 





Get Started with MicroPython 


on Raspberry Pi Pico 





ea) Raspberry Pi 
= Press 

< 

Ze Price: 

wa £10 / $14 


magpi.cc/picobook 


Jpalerom Dloverbhaatsyeue-laleyel 


MicroPython is one of the 

two languages used to control 

the new Raspberry Pi Pico 

microcontroller board (the 

other being C/C++). Based upon 

Python 3, it will be a vital tool for 

controlling your brand new Pico. 
Get Started with MicroPython on 

Raspberry Pi Pico, by Raspberry 

Pi Press, is our primary 

knowledge resource for those 

looking to use Pico. Written 

by Gareth Halfacree and 

HackSpace magazine editor 

Ben Everard, the book walks 


you through setting up the 
board and learning physical 
computing techniques. 

After setup, each chapter 
covers a tutorial for building a 
range of starter projects: traffic 
lights, reaction game, burglar 
alarm, temperature gauge, 
data logger. The final chapter 
explores using the [2C and SPI 
digital communication protocols 


to display data on an LCD screen. 


While the primary focus is 
on electronics and integrating 
Raspberry PI Pi Pico into real- 


Get started with 


MicroPython 


on Raspberry Pi Pico 





world projects, each chapter 
focuses on an aspect of 
MicroPython and you’ll learn a 
lot as you go. 

This book is the best place 
to start with Raspberry Pi Pico. 
Make sure you pick up a copy. 


A. 
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Keep these vital documents to hand 


MICROPYTHON 
DOCUMENTATION 
Bookmark the MicroPython 
documentation website for a 
complete reference guide to 
libraries and modules. 
docs.micropython.org 


RASPBERRY PI DATA SHEETS 
Data sheets, including SDK 
information for MicroPython and 


C/C++, are found on Raspberry Pi's 
data sheets section. 
datasheets.raspberrypi.org 


PICO PYTHON SDK 
DOCUMENTATION 

Download the Pico Python SDK 
documentation PDF for a complete 
guide to working with MicroPython 
on Raspberry Pi Pico. 


magpi.cc/picopythonsdk 
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MicroPython documentation 








Programming 


“= O'Reilly As you move beyond Raspberry 

‘e) e e e 

E | Pi Pico and into a broader 

bj ay an MicroPython experience, you 

s 7 : should take a look at Nicholas 
magpi.cc/ 


Tollervey’s Programming with 
MicroPython. 

It explores a variety of 
devices that run MicroPython, 
from PyBoard to Adafruit’s 
Circuit Playground Express and 
ESP8266/ESP32 boards. 

The book has a detailed 
overview of MicroPython 
and how various embedded 
technologies can be used to 
make devices. It covers input 


pwmicropython 


i Raspberry P1 Pico website 





*4) Raspberry Pi There is a wealth of 

2 information and resources 

= Price: available on Raspberry Pi’s 
ey Free official Pico website. You will 


pico.raspberrypi.org 


probably come across this 
website during the MicroPython 
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Nicholas HL Tolhervey 


and output, GPIO, various sensor 
technologies, networking, sound 
and feedback, and works up to 
building a wheeled robot. 

You can read chapter 
one online (magpi.cc/ 
pwmicropythonc1) to get a feel 
for the text. While it doesn’t 
cover Pico, the book offers a 
thorough grounding in the 
MicroPython language. 


setup process (as you flash 
Pico to work with MicroPython 
rather than the default 
C/G SDK), 

Make sure you bookmark it 
and come back. It has links to 
the MicroPython wiki 


—e Z and forum, as well 


as links to much of 
the documentation 
listed here. 

There are also 
project examples to 
offer inspiration for 
the kinds of things you 
can do with Raspberry 
Pi Pico (and you can 
expect a lot more of 
this in future editions 
of The MagPi). H 
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Learn MicroPython 
with these websites 





REALPYTHON 


An Intro to Programming 


Hardware in Python explores 
using Python to control 
microcontrollers and 
hardware devices. 
realpython.com/micropython 


UDEMY 

Udemy has a complete 
range of video tutorials 
based around MicroPython. 
Most are based around 

the PyBoard now, and we 
expect Pico courses to be 
available shortly. 
udemy.com/topic/ 
micropython 


MICROPYTHON FORUM 
Learning from others is a 
great way to gain knowledge. 
The MicroPython community 
is a great place to meet like- 
minded Learners. 
forum.micropython.org 
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VW The spy foam 
camera seems a lot 
more conspicuous 
than we imagined 





Kids Invent Stuff 


Ruth and Shawn bring kids' invention ideas to life on their YouTube channel 


> Name Ruth Amos and Shawn Brown 


> Community role Makers — | 


e all had outlandish/ 

amazing ideas as kids 

that unfortunately 
we did not have the skills or 
resources to carry out. Perhaps 
sometimes for the better. The 
team of Ruth Amos and Shawn 
Brown might be able to help 
these kids, though, with Kids 
Invent Stuff. 

“Kids Invent Stuff is a YouTube 

channel which brings to life 
kids’ invention ideas, created to 
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inspire primary aged children 
around engineering and STEM,” 
they tell us. “Young people are 
encouraged to submit their own 
ideas for inventions to solve 
novel and entertaining technical 
challenges. The most creative 
and entertaining inventions are 
then showcased as part of Kids 
Invent Stuff YouTube episodes. 
The chosen idea is then built 
and demonstrated on film, with 
often hilarious consequences; 


| |» Occupation YouTubers 
> Website magpi.cc/kidsinventstuff 


we’ve built furry electric dog 
cars, popcorn-firing doorbells, 
and alarm clocks that wake you 
up by dropping pool balls on 
your head. These have all been 
inventions designed by children 
that we have brought to life.” 

Ruth is a self-taught engineer 
and inventor. In 2006 she was 
Young Engineer for Britain 
with her GCSE product ‘The 
StairSteady’, which is now sold 
internationally. She is a keen 
welder and maker and co- 
founded #GirlsWithDrills with 
Kisha Bradley. 

Shawn Brown is an engineer, 
artist, and designer. Asa 
multidisciplinary engineer 
and artist, he has worked ona 
myriad of projects; from building 
custom electric vehicles, to 
bringing to life the 12m tall 
‘Man Engine’ — the Uk’s largest 
mechanical puppet. Shawn has 
both a master’s degree in Energy 
Engineering and a master’s in 
Fine Art. 


How has Raspberry Pi helped 
some of your builds? 

We have used Raspberry Pi 

in anumber of builds. We 


worked with Estefannie, 
from Estefannie Explains 
It All, to hack our rainbow 
unicorn that poops jellybeans 
(invented by eight-year-old 
Tru, Magpi.cc/unicornpoop) 
to be able to poop jellybeans 
when someone tweeted 
it: Magpi.cc/unicorndemo. 
This year, we built nine- 
year-old Nathan’s foam- 
firing spy camera, which 
was built around a Raspberry 
Pi. You can see it in action 
here: magpi.cc/foamspydemo. 


™ A YouTube 
channel which 
Drings to life kids’ 
Invention ideds @ 


What has the response been to 
your videos? 

People seem to love seeing kids’ 
invention ideas come to life 

and we’ve had some fantastic 
comments from parents and 
teachers saying that their 
children and students have 


& 


A lt'sawhole new world out in 
the harbour ona floating rug 


been inspired by the channel; 
in fact, over 95% of those 
submitting ideas have said that 
our channel and challenge had 
helped improved their child’s 
understanding of engineering. 

The project was set up because 
research showed that it was 
really important to inspire and 
keep engaged young people, 
particularly girls, into STEM 
while still at primary school. 
Kids make amazing problem 
solvers and we wanted to 
showcase and celebrate that on 
the channel. Hl 














> magpi.cc/popcorndoorbell 


Giant Rube 
Goldberg Machine 
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GIANT KIDS’ CHAIN REACTION 


> magpi.cc/rubegoldberg 


Zander’s Robot 
Shopping Trolley 


> magpi.cc/robottrolley 


INTERVIEW | Magri 





A The tea train will 


arrive, whatever 
type of snow is 
on the line 
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THIS MONTH IN RASPBERRY PI 





Raspberry P1 





MagP1 Monday 


Amazing projects direct from our Twitter! 


very Monday we ask the question: have you 

made something with a Raspberry Pi over 

the weekend? Every Monday, our followers 
send us amazing photos and videos of the things 


they’ve made. 


Here’s a selection of some of the awesome things 
we got sent this month - and remember to follow 
along at the hashtag #MagPiMonday!! H 





01. 
02. 
03. 


04. 
05. 


06. 


07. 


08. 


09. 


10. 
11. 


Don't panic, you'll scare the robots 
Balancing robots are just magic 


PiMowBot continues to be developed and 
is very cool 


Some very classic 3D graphics test here 


This is not the only project we've seen that 
gets mad at 2020, but it is the cutest 


We're looking forward to seeing the Pi 
Wars 2021 robots in action 


We like the idea of using e-paper as a 
photo frame! 


It's cool to see the advanced features 
of the HQ Camera made accessible in 
this way 


Jitesh’s robot experiments are always great 
to see 


We love the aesthetics on this 


We like the look of this robot! 
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Ciprian Manea 
= @ovipic 


Replying to @TheMagPi 






panicking about @PiWarsRobotics, ... | mean 
strategizing and dusting off the @unpi_ong #RVR & 
#unPi for #PiWars 






Ratpibotics 
@raspibotics 






Replying to @ThebdagPi 





#NMiagPiMonday I've got made a nice little backpack for 
@RoboMABEL and fixed the WiiMote controls. Next on 
to moving the legs! 


=. 


MagPi 


TED P otkin 
@TGD_ Consulting as : ‘ athinson 


Replying to @TheMagPi Replying te @ThelMaghi 
Tim brainstormed on a solar panel alternative, since the ears about with the V3DV Vulkan Mesa driver for 
| 


current panel has reached its end of life & is no longer 
made in the same dimensions. And | finished an online 
tutorial on building and setting up a PiMowBot. 


@ TED @IGD_Consulting - Dec 17, 2020 
Eine passende Alternative fir das bisherige 20W mono Solarpanel ist gefunden. 
Das Design des PiMowBots vérandért sich dadurch nur unwesentlich bei gleicher ae 

7 : ts and a Byte 
PY-Leistung. Demndchst mehr Infos... & 


Heitcandabyte 


Reirey fo © Tie taay Pi 


Make # Dy #3 0printed #loT #smart #robotics #lawnmower based on 
#RaspberryPi. Goodmorning! 
We built an internet controllable robot world that 
smashes 2020 with 3D printed fire! Extra bonus: it's 
voiced by one of our fayourite makers ever! 
@hannahmakes 













Replying to DThehklagh 

y I've finally got the @Raspberry_Pi HO cam module 
working well with the @ArducamOfficial CSI to USB 

) board as a webcam. Settings tweaked to increase gain, 
decrease brightness and increase saturation to give a 
MUCH better picture quality. 


rian Corteil 7 j Waar a mask to protect fi neqpect others ; F 
peta on ap PauiChark_ Wicr New mount designed and 3D printed too! 


ShCannanfockdar 
J io Ghee F _ 


A9.7 inch e-paper photo thingy with a Pi 34 





Replying to @TheMagFi 

Finally putting together my robot for #PiWars 2021. 
Meet ‘Testbed’ based on the Tiny 4WD chassis. 
Macatruit Braincraft hat for meat bag duties & Motor 
Bonnet for driving the motors. A small banana for scale. 


a 
: 








John Chinner Bee 


Conn Mrineer 





Replying to @TheMagPi 


Building myself an @ExoMy_Rover ! 





Rob 


ira fiel gris 1m | 


B Jitesh Saini 
= ig [he Aa DL 


Rephng to Theblaghi 


Repihyirscy bee a Te MiarPr 


| released an update to “pitfalls” - a #MicroTonal music 


Used h Ae reer scale explorer library for the #Monorme #Norns shield - 
sed a smart phone as a compass sensor to achieve pictured here running on a #RaspberryPi 38+ 


precise direction control of my @Raspberry Pi robot. 
The compass works through a browser, thanks ta 
#javascript APIs. Try the apps created for this project . 
using your smart phone with robot simulator here 
helloworld.co.in/article/compas... 
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Lastofthe 
Christmas projects 


Pack away your festive Builds for another year 














Now that the Christmas decorations are up lve worked 
an 4 ficheerhohts cantralled mint Christmas tree, with 4 
pi zero W getting the latest cheerlights colour and 
syncing up with all the other cheerlights across the 
weorhd 


& Siewart Viatiches 
e were unable to fit all of the amazing projects eaiiecg 


from December until now. Because we love A Christmas Project using the Raspberry Pi Snow? RGB 


Christmas projects, we're putting them in our from @ryanteck 
pro) p g 





February issue to make sure they get noticed. H] 


I'S a game which can be played using a USB controller, 


Can you react fast enough when the nose or eyes light 





up? 
01. Games and Christmas? We can't imagine a Includes a version that doesn't need SnowPi - just 
more Iconic duo Pygame Zero 
02. Two great projects that go great together — Raspberry Pi SommwPi RGB Garme - Civitas Game with PE 
03. We feel that the Shelf Elf does not needa So eee 





power-up 





04. This project is very important, don't let 


Martin Parker 
anyone tell you otherwise ir} ker 


fear Martin 









Ri Ir GT Aevoagrei 


05. We love this idea! What other public 
decorations are controlled by Raspberry Pi? 





| made an #lronElfOnTheShelf using a #raspberrypi zero 
w, an old #sky box playback spinner, a bit of python 


06. It took us amoment to realise how big this and using crontab to set it running every hour. 


tree was - that's a Sense HAT on top! 


¢ Scott Young 


TheblagPhi 


Played with a Christmas Tree window decoration, 

including a Sensehat as a colour-changing star / 

message display. 

It is networked but | haven't connected it to the Internet 

e Young in Cheshire mm yet. | might get it to display tweet messages (filtered of 
Pree rer ih) course!) 


With a 4 year old this is the most important project - a 
sleeps countdown to Christmas €8. For the snowball 
each flake has its own physics! Pi zero W again to get 
the date and work the display, been a very Christmas/ 
Pi heavy week! 














Thea 
Sending messages with lights: town Christmas tree lit 
with almost 2000 LEDs controlled by @Raspberry_Pi 
showing text messages in Morse Code @LightsMessage 
#EveryLightAMessage 
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Air Monitoring HAT 


Real-Time PM Sensor For Raspberry Pi : 








» PMSAO0S Sensar * Siandard Raspberry Pi 40 Pin GPG 
* OLED Display 0.91" ® IAAT (serial) interftaca 
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Smart Fan 





An open-source portable sensor that can measure air Active cooling solutions are quite popular for 
quality. In many cities this can be quite important. It's Raspberry Pi 4, and this smart fan is yet another. It also 
already been funded, so give it a look to see if it’s the allows other HATs to be added on top, and away from 
kind of sensor you'd like to use. Raspberry Pi. It's apparently whisper quiet. 

>» kck.st/35u0il0 >» kck.st/30dDAeB 


www.hifiberry.com 





L 
OR HIGH END? 


Pick the HiFiBerry DAC for Raspberry Pi, that fits your needs 
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Meeonen esac recaeee na 


HiFiBerry DAC2 Pro 


Optimised layout for best audio quality 
Headphone output 

Can be equipped with an addional DSP 
board 





HiFiBerry DAC2 HD 


Higher dynamic range 
Lower noise floor 

Lower distortion 

Can be equipped with an 
additional DSP board 
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, V The weekly live streams cover a wide range of computing topics 
Pi aem am \iele)a 
Digital Making 





— 
I was very surprised to see that HackSpace at Home 
Magazine was released with a new type of Selopeedettansteaieteetuaien ometalateadl 
Raspberry Pi on the cover, much like you did eames 


with Raspberry Pi Zero ages ago. Can we expect 
to see Pico on the cover of The MagPi? Will you 
cover it like you do Raspberry Pi, or do you not Storytelling 

do microcontrollers? ny, wit.. technology 





Wedneeday, 20 January 


David vid email EN fs yy cart 


Unfortunately not this time. HackSpace magazine M=Yolaayialemisevanmaleianla 


is one of our Raspberry Pi Press siblings, so they 


get the honour as they launched the same day. Are there any resources you recommend for 
As for coverage, we’ ll absolutely be doing stuff children learning computing from home? Our 
with Raspberry Pi Pico. We don’t really shy away youngest has a Raspberry Pi 400 and is eager 
from microcontrollers, and we definitely love to to learn more about it! 
talk about Raspberry Pi stuff. We’re hoping to have 
¥ Read more about many tutorials for Pico in the coming issues and Wendy vig Facebook 
Raspberry Pi Pico on 
page 60! years to come! 


The Raspberry Pi Foundation offers a lot of 
ways to help teach from home if you need to, or 
even if you just have an eager young maker who 


— : — wants to do something at the weekend. 
berr J Pi Pico OF. y 20 a BOOTSEL tel This great blog entry from Raspberry Pi 


x Foundation CEO Philip Colligan lists all the 
zy rs ways you can help young folk with digital 
making: magpi.cc/learnhomeblog. 
This includes stuff like the Teach Computing 
Curriculum which has comprehensive lessons 
t plans for all key stages, as well as Isaac 
Computer Science for A levels. There are also 
the weekly Digital Making from Home streams, 
our sister magazine Hello World, and the 
Raspberry Pi Projects site. 
There’s a lot to get stuck in to! 
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Auf Deutsch 


I’ve just contributed to get 

the 4th Edition of The Official 
Raspberry Pi Beginner’s Guide 

in English. But, actually, Iam 
looking for the German version. 
Is it published only as a book or 
is it also available as a PDF file? 
Please let me know. 


Tim vid email 


If we’ve published something 
via Raspberry Pi Press, then 
chances are you can get itasa 
free download! In the case of 
The Official Raspberry Pi Beginner’s 
Guide 4th Edition, where there 
are multiple translations, 
you can find a drop-down 
menu for the language on the 
product page (which is here: 
magpi.cc/bguide4). It will even 
have the description in that 
language as well! 

In addition, you can 
buy a physical copy of the 
Beginner’s Guide in all the 
available languages. 
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V Submit your project to be in the online showcase gallery! 


2020 SHOWCASE GALLERY 









Protect the planet! Burglar Buster 


Tie 
mere 
= 
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Coolest Projects 


Will there be any Coolest Projects events in 20212 I’d love to enter 
a project for it as I have some amazing ideas I’d like to try out! 








Parivic Twitter 


It was recently announced that there will be another online showcase 
in 2021 for Coolest Projects! While no date for the actual event has been 
confirmed yet, you’ll be able to register for it, starting on 1 February. 
All projects will be shown in the online showcase gallery online, so 
there’s competition for space! It’s also completely free to enter. Check 
out more info here: magpi.cc/cp2021. 


Contact us! 


> Twitter §@TheMagPi 


> Facebook magpi.cc/facebook 
> Email magpi@raspberrypi.com 
> Online raspberrypi.org/forums 
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HackSpace 


TECHNOLOGY IN YOUR HANDS 
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IW RIN 
RASPBERRY PI 
PICO BOARDS 


AND GET STARTED WITH 
MICROPY THON BOOKS! 


e Python 
icroPythy 
Se Raspberry Pi Pico 
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To celebrate the release of 






the amazing Raspberry 
Pi Pico board, were 
giving ten away with 

a copy of the official Get 
Started with MicroPython on SSS 
Raspberry PiPicobook that § “i axaaaamiis 
will helo you get stuck In 


with your new microcontroller. 


Head here to enter: magpi.cc/win | Learn more: magpi.cc/pico 





Terms & Conditions 


Competition opens on 27 January 2021 and closes on 25 February 2021. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, 
the prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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takes the most common 
computer problems and tells you 
how to fix them. Its as simple 
as that! If you've ever wondered 
why your laptop wont turn on, 
you cant get a WIFi connection, 
your printer isnt printing, or why 
everything is so slow — well, this 
is your book... 
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There and back 


again with silicon 


Keeping secrets and writing documentation. By Alasdair Allan 


here is a new thing in the 
T world, and I had a ringside 
seat for its creation. For me, 
it started just over a year ago with 
a phone call from Eben Upton. One 
week later I was sitting in a meeting 
room at Raspberry Pi Towers in 
Cambridge, my head tilted to one side 
while Eben scribbled on a whiteboard 
and waved his hands around. 

Eben had just told me that 
Raspberry Pi was designing its own 
silicon, and he was talking about 
the chip that would eventually be 


telescopes, I became interested in 
machine learning, and what later 
became known as ‘big data’. From 
there, I spent time investigating 

the ‘data exhaust’ and data living 
outside the cloud inside embedded 
and distributed devices, andasa 
consequence did a lot of work on 
mobile systems. Which led me to do 
some of the thinking, and work, on 
what’s now known as the Internet of 
Things. Which meant I had recently 
spent a lot of time writing and talking 
about embedded hardware. 


M | gradually drifted sideways Into playing 


with the toys @ 


known as RP2040. Eben started out 
by drawing the bus fabric, which isn’t 
where you normally start when you 
talk about a new chip, but it turned 


out RP2040 was a rather unusual chip. 


I get bored easily. I started my 
career doing research into the high- 
energy physics of collision shocks in 
the accretion discs surrounding white 
dwarf stars, but I gradually drifted 
sideways into playing with the toys. 
After spending some time working 
with agent-based systems to solve 
scheduling problems for robotic 
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Eben was looking for someone to 
make sure the documentation around 
Raspberry Pi Pico, and the silicon itself, 
was going to measure up. I| took the job. 


Rumour mill 

I had spent the previous six months 
benchmarking machine learning (ML) 
inferencing on embedded hardware, 
and a lot of time writing and talking 
about the trendy new world of 
TinyML. The rumours of what I would 
be doing for Raspberry Pi started 
flying on social media. The idea that 


I was there to help support putting a 
Coral Edge TPU onto Raspberry Pi was 
a particularly good wheeze. 

Instead, I was going to spend the 
next year metaphorically locked in 
a room building a documentation 
toolchain around — and of course 
writing about — a totally secret product. 

I couldn’t talk about it in public, 
and I talk about things in public a lot. 
Only the fact that almost everyone 
else spent the next year locked indoors 
kept too many questions being asked. 

I’m rather pleased with my first 
year at Raspberry Pi, and with how my 
work on RP2040 and Raspberry Pi Pico 
turned out. Much like a Raspberry Pi 
is an accessible computer that gives 
you everything you need to learn 
to write a program, RP2040 is an 
accessible chip with everything you 
need to learn to build a product. It’s 
going to bring a big change to the 
microcontroller market. Hl 


Alasdair Allan 





Alasdair Allan is a scientist, author, hacker, 
maker, and journalist. He writes, speaks, 
and builds. He accidentally ended up as a 
privacy advocate, and is now responsible 
for documentation at Raspberry Pi. 


alasdairallan.com 
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